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PREFACE 



The purpose of this manual is to help you 13600016 familiar 
with the Multics system. This manual provides you with a basic 
introduction to Multics, a workbook that guides you through your 
first sessions at a terminal. The topics covered here are 
fundamental Multics concepts that are immediately useful to the 
new user. Many examples are included, illustrating both correct 
and incorrect ways of sending instructions to Multics. Many of 
the concepts presented here are covered more thoroughly in Part 
II. 



Section 1 of this manual introduces the Multics system. 

Section 2 covers how to enter and leave Multics. Multics 
conventions are presented in Section 3, as you learn to use 
several basic commands (instructions). Here you are also 
introduced to communication with other users via Multics. 

In Section 4 you learn to enter text or other information, 
in units referred to as segments, for storage and processing on 
Multics. Segments are discussed more fully in Section 5, which 
also includes commands allowing you to manipulate your own 
se2;ments . 



_The organization of all users' segments is explained in 
Section 6. This section also suggests ways of organizing your 
own segments, and describes commands for using other people's 
segments. Commands concerning access control (permission to 
share segments with other users) are presented in Section 7. 

A glossary of the terms used in this manual can be found in 
Appendix A. Appendix B contains a list of the commands 
introduced in the manual, including the correct usage and a brief 
description for each. 
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The information presented here- is a subset of that contained 
in the primary Multics reference document, the Multics 
Programmers' Manual (MPM) . The MPM should be used as a reference 
to Multics once you have become familiar with the concepts 
covered in this introductory guide. The MPM consists of the 
following individual manuals i 

Reference Guide Order ITo. A'G-91 

Commands and Active Functions Order No. AG-92 

Subroutines Order No. AG93 

Subsystem Writers' Guide Order No. AK92 

Peripheral Input/Output Order No. AX49 

Communications Input/Outpu t Order No. CC92 

Throughout this manual, references are made to both the MPM 
Commands and Active Functions manual and the New Users' 
Introdu"ction to Multics Part II . For convenience, these 
references will be as follows: 

MPM Commands 
Part II 



The Multics operating system is referred to in this manual 
as either "Multics" or "the system". The term "computer" refers 
to the hardware on which the operating system runs. 
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SECTION 1 



INTRODUCTION 



THE MULTICS SYSTEM 

A large-scale compiiter is a machine that can store very 
large amounts of information, and can process that information 
very quickly. A computer consists of hardware , all the physical 
devices and electronic circuitry, and software, all the programs 
and other machine instructions that control the activities of the 
computer. The software is said to "run" or "execute" on the 
hardware . 



In order for people to use a computer, there must be a set 
of programs within it that can interpret users' instructions, 
control the hardware, and otherwise supervise the basic operation 
ux oiic compuiuci . xnxo jjui uxon ux one Suxowaie xS caxxeu one 
operating system . 

Your operating system is called Multics. It is a 
general-purpose system developed to serve large and diverse user 
communities. Because Multics is a timesharing system, the work 
of many users is processed almost simultaneously. The normal 
mode of operation on Multics is interactive , or "conversational": 
each instruction that you type goes directly to the computer and 
is acted on immediately; if Multics needs any further 
information from you in order to follow your instruction, you are 
asked for it. In addition, all of your work can be seen and used 
by other users through a system of access control : levels of 

"n R T* m n P « "i o m r>nn+. t*oT T or! "htr ■'.mm 
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You will do your work on Multics from a terminal ; in fact, 
this may be the only piece of hardware you see. A terminal looks 
very much like an electric typewriter (or a television screen) 
with extra keys. It is connected to the computer, either 
directly or through normal telephone lines. Although there are 
many different kinds of terminals, each with slightly different 
keyboards and instructions for use, all terminals can be classed 
as either printing terminals (also called "hard-copy" terminals 
because they print onto paper) or video terminals (with a screen 
and cathode ray tube, CRT, rather than paper). 

MANUAL CQIIVEi^TIQIS 

A few conventions and special symbols should be introduced 
before you begin to explore the Multics environment. 

Technical or other unfamiliar terms are underlined when used 
the first time, and are included in the glossary (Appendix A). 

Quotation marks are used to indicate the exact spelling of a 
way a word should appear on a line typed by a user. 
For example, part of a person's identification on Multics is 
called a Per3on_id, and that term is unquoted, but a specific 
example of it, say "PSissle", is quoted. You do not type these 
quotation marks. 



Another convention within examples is the use of an 
exclamation point to indicate lines you type. The exclamation 
point does i^OT appear on your terminal — you do not type it, and 
Multics does not type it to prompt you. Exclamation points 
appear ONLY in examples, and ONLY to show which lines you type. 

Line numbers and text within angle brackets (<...>) are used 
within examples for explanatory purposes Oi^LY. They are not 
actually typed by Multics, and they should not be typed by you. 

MULTICS CONVENTIONS 

Several characters have special meanings on Multics. 
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Two special characters are deletion characters that you can 
use to correct typing mistakes. To delete single characters, use 
the "#" character (called the erase character) directly after the 
characters you want deleted, one "#" for each character you want 



nru-, 
J. Ill 
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! My name is Pm#am 



is seen by Multics as: 



My name is Pam. 



The erase character, when used to erase a blank space, will erase 
ALL the blank spaces between characters. For example, this line: 



! My namei 



5### is Pam. 



IS seen as: 




because the first # erases the "s", the second erases the next 
row of 4 blanks, and the third erases the "i". 

The "@" character (the kill character) deletes all 
characters to the left of it on the line; for example: 



Myn aemi s@My name is Pam. 



is seen as : 



My name is Pam. 
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You should avoid some characters unless you are specifically 
instructed that you may use them. These are: 




You will learn about the correct use of these characters in Part 

II. 



On Multics, names are not allowed to contain blank spaces. 
If a name consists of more than one word, the " " (underscore) 



used to separate the words. For example 



character is 

send_message command name has an underscore connecting 

words. This convention is treated fully in Section 3. 



the 
the two 



Other characters have special meanings only 
contexts. Such characters are noted where necessary. 



m some 
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SECTION 2 



ENTERING AND LEAVING MULTICS 



Entering the Multics system is called logging in 
leaving the system is called logging out. 



and 



USER IDENTIFICATION ON MULTICS 

To successfully log in on Multics, you must be registered as 
a Multics user at your site. When you get registered, you are 
assigned your own identifying name, called a User id . Here is a 
sample User id: 



PSissle.DoG 



Tnere are two components, separated by a period, in this User id: 
the Person id (PSissle), which is a unique (to Multics) version 
of Pam Sissle's name, and the Project id (Doc), an abbreviation 
of the name of the group she works with, which is included for 
administrative and accounting purposes. (A third component, the 
tag, is discussed in Section 7.) 



Your User_id identifies you as a registered user, with 
authorization to use the resources of the system: computer time 
for interacting with the system and space (memory) to store the 



work you've done. Although your 
and can be known by everyone. 



User_id is unique, it is public 



You also receive a preliminary password when you register. 
One of the first things you learn to do on the system is to 
change the assigned password to one you make up, so that it will 
be completely private. Your password ensures that only you can 
log in with your User_id because you are the only person who 
knows what your password is. The password system is the most 
important key to the security that Multics offers. 
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CONNECTING THE TERMINAL 

Now you are a registered user, sitting at a terminal. After 
turning the terminal on (there is an on/off switch on the body of 
the terminal), you must make an electronic connection between it 
and the computer. Before you make this connection, the terminal 
is just another electric typewriter, with a few extra characters 
on the keyboard. (if you have a hardwired terminal — one that 
is connected directly and permanently to the computer — you are 
ready to turn to the next part of this section and log in.) This 
procedure is simple, but it differs slightly at each site. Your 
site probably has detailed instructions available. Here is a 
general description of terminal connection. 

Terminal connection is made through normal telephone lines 
using a modem . The modem sends electronic signals to and from 
the terminal in the form of high-pitched tones. It may be built 
into the terminal, or it may be a separate unit connected by a 
cable to the terminal. If it is built in, you see only a cradle 
that accepts a telephone receiver, and there is a regular 
telephone nearby. Otherwise, you use a dataset, which looks very 
much like a regular telephone with several pushbuttons along it. 

Pick up the telephone receiver, listen for a dial tone, and 
dial the phone number of your system (this number should be 
included with the instructions for your particular site, and may 
also be posted near the terminal). You will hear the phone 
ringing, and then a steady shrill tone when the connection is 
made. At this point, if you have a built-in modem, place the 
receiver firmly into the cradle, with the cord positioned as 
indicated on the unit. If your modem is a dataset, push the 
indicated button (labeled "DATA" or "HOLD") and then set the 
receiver back into its place on the modem. Usually, either the 
modem or the terminal turns on a small light when the connection 
is made. When this light goes off, it means you are 
disconnected . 



Terminal connection sounds complicated, but it will become 
automatic for you very soon. If you have problems, make sure 
everything is plugged in and turned on, and ask another user for 
assistance . 



Logging In 

When you have successfully connected your terminal, Multics 
prints a banner , or greeting message. This is the signal for you 
to log in and identify yourself. Here is a sample login sequence 
for Pam Sissle, opening with a typical site banner. The lines 
are numbered for this example ONLY; the example is followed by an 
explanation of each line. 
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1 . Multics MR8.0: Honeywell LISD Phoenix, System M 
Load = 42 out of 125-0 units: users = 39- 05/02/80 

2. ! login PSissle Doc 

3. Password: 

4 . ! pwsWMMMKWraK 

5. You are protected from preemption until 1007-8 

6. PSissle Doc logged in 05/02/30 0907-5 mst Pri from 
7- Last login 05/01/80 1326.4 mst Wed from ... 

8. r 10:07 1 -486 34 



NOTE: Remember that you do NOT type exclamation points or 
line numbers to begin your command lines. 
Exclamation points are provided in this manual only 
as an aid to readers, to indicate lines that are 
typed by a user. Line numbers are used only for 
purposes of explanation. 

1 . The typical Multics banner is a two-line message giving 
the current version of Multics software, the name and 
location of your site, the number of people logged in, 
the total number of users the system can accept at one 
time, and the date and time. 

2. The word "login" is the command (a command is a 
specific instruction to the computer) that identifies 
you and gives you access to Multics. Actions that you 
want performed by Multics are conveyed by commands. 

Follow the login command with a space and your own 
Person_id and Project_id. Then press the RETURII key 
(this key may be labeled "RET" or "CR" on your 
terminal). All lines sent to Multics must be 
term.inated by typing the RETURN key or else Multics 
will not act on them. This is a complete command line . 

3. The login command is an interactive command: it 
responds to your Person_id and Project_id by requesting 
your password. 

4. Both you and Multics use this line. First Multics 
prepares to conceal your password, so that nobody can 
read it. Depending on the kind of terminal you have, 
the printing of your password is either suppressed 
entirely or hidden in a string of cover-up characters. 
Then you type your password, and the RETURN key. 

In this example, Pam Sissle typed in her preliminary 
password of "pws", her initials (all lowercase). Pam's 
password is left visible in these examples to 
illustrate the correct response to the login password 
request . 
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5- This message tells jou how much time you are guaranteed 
on the system during this login session; after the 
stated time (here it is 10:07 am), you may occasionally 
be logged out (with advance warning), but usually you 
have as much time as you want. This line also serves 
as acknowledgment of a successful login. 

6. Your User_id and the date, time, day and location of 
your current login session are listed. 

7. The date, time, day and location of your last login 
session are listed. You can use this information to 
detect unauthorized use of your User_id and Person id 
and Project_id. Multics will also inform you here~of 
any unsuccessful attempts to log in using your 
Person_id and Project__id (including your own attempts, 
if you misspell your password) . 

8. The last line is a ready message . Included in this is 
the current time of day (on a 24-hour clock), and other 
information that reflects your use of system resources. 
The ready message appears when you are at command 
level: whenever Multics is ready to receive another 

s^ '^ 1.XA Ajtx <_^ i. J. V.«. _i_ J. V_/ Xii y '^ V^ • 

How you are ready to begin working on Multics. 

logi:j problems 

It is possible that the first time you type the login 
command line, you will not receive the prompting message 
"Password:". In fact, almost nothing will happen: your carriage 
(or cursor , the white square or blinking underscore on video 
terminals) moves over to the beginning of the login line without 
moving down to the next line. In this case, also press the LF 
(or LINEFEED) key. After you receive the prompting message and 
type your password, press both the RETURN and the LP keys again. 
When you receive the ready message from Multics, type: 

set_tty -modes If echo, crecho 

and both the RETURN key and the LP key. From now until you log 
out, you can type just the RETURN key to send your command lines 
to Multics. 



You will learn more about the set_tty command in Part II, 
but for now, if you do not want to type this command line every 
time :fo\i log in, ask your project a dministrator to make your 
RETURN key include a line feed permanently. (Tou can also do 
this yourself after reading the "exec_com" section in Part II.) 
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i-.r^./L^rmn !v.^ mistake while logging in, and you have already 
typed RETURN without using the erase or kill characters, Multics 
tells you by printing an error message , and asks you to try 
again. Several error messages are shown in this section. 
Xu^Z^^T. ^"^"'"^^ "^^"^ "^^ ciiui message wnenever you send it a line 
that It cannot process, because of incorrect format or inadequate 
^..^^^^a^^^.,, ^,^ -aiju nc3.t= occurred when you receive an error 
message; check your command line and try it again. 



^^. Here is an example of a typing mistake (Psissle rather than 
PSisslej on the command line: 



login Psissle Doc 

Password: 

pwsKKKMKMKKK 

The user name you supplied is not registered. 

Please try again or type "help" for instructions. 

login PSissle Doc 



Although the error was on the first line, Multics checked' for a 
matching password before sending an error message. When you try 
again, start with the login command line. 

Typing mistakes are the most common errors. It is important 
to type words exactly as they are indicated, with attention to 
both uppercase and lowercase letters (Multics distinguishes 
Dexween uppercase and lowftrnaRp). 



Here is another example, in which Pam forgot the space after 



tne command: 



! loginPSissle Doc 

Incorrect login word "loginPSissle". 

Please try again or type "help" for instructions. 
! login PSissle Doc 



Another easy mistake to make 



, -, / - is to type your password 

incorrectly. (It is also hard to correct a mistyped password 
using tne erase character, because you cannot see what you 
typed.) Multics responds this way: 
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login PSissle Doc 

Password : 

owsWKKWKKKM 

Incorrect password supplied. 

Please try again or type "help" for instructions. 

login PSissle Doc 



After you mistype your password, you must type the entire login 
sequence again, beginning with the login command. 

Each site administrator sets a limit to the amount of time 
you have and the number of attempts you can make to log in during 
one session; you usually have about 6 minutes or 6 tries. When 
you have exceeded this limit, Multics tells you to hang up the 
telephone, because it is automatically breaking your terminal 
connection: 



login PSissle Doc 

Password : 

owsKKMKWWKWW 

Incorrect password supplied 

hangup 



If you typed everything correctly but are still denied 
entrance to Multics, you may not be registered yet. Check with 
your project administrator if you think this is the case. There 
may be other reasons for denying you access, such as a system 
shutdown, for which you receive an explanatory message from 
Multics . 



Logging Out 

When you finish your work on Multics, wait for a ready 
message and type the logout command to break your terminal 
connection. Multics responds by printing your User_id, the date 
and time that you log out, and your total system resource usage. 
It then reminds you to hang up the telephone: 



r 1 1 :2[) 0.072 68 

logout 

PSissle Doc logged out 07/25/80 1125 mst Pri 

CPU usage 13 sec, memory usage 5-6 units, cost $2.58 

hangup 
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Do not hang up the telephone before Multics has logged out; wait 
for the word "hangup". 



nrr 



telephone, and turn 
wasting computer time 



You should always log out, hang up the 

and to allow others to use the terminal. If you do not log out, 
another person can issue commands that Multics will interpret as 
being from you. This activity is charged to you, and may also 
result in damage to your work. 



Login/Logout Variations: Control Arguments 

Most commands are flexible, letting you vary the way the 
commands work. The command name specifies an action to be taken; 
to direct the action of the command, you supplement it with 
information by typing words called arguments after the command 
name. The different kinds of arguments are discussed fully in 
Section 3, but one kind is of special interest to you at this 
point: the control argument. 

The control argument is distinguished from other kinds of 
arguments by the hyphen which always precedes it. It is used as 
an optional argument — one that you include on the command line 
if you want the variation it stands for. Both the login and the 
logout comimands take control arguments. You are introduced to a 
few of the most useful ones here. 



The most important control argument for the new user, used 
with the login command, is -change_password. As discussed above, 
it is very important that you be the only person v7ho knows your 
password. Here is an example of how to change a password: 



login PSissle Doc -change_password 

Passv/ord: 

pwsKKKKMMKW 

New Password: 

newpassKKMKK 

New Password Again: 

newpassKKKWK 

Password changed. 

You are protected from preemption . 

PSissle Doc logged in 07/26/80 ... 

Last login 07/26/80 . . . 

r 11 :27 2.019 889 
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Your password must be 8 characters or fewer (with no blanks). 
You may change your password as often as you like, but do not 
choose a word that people are likely to guess, such as your 
initials or the name of a pet. Try not to forget the one you 
use, because there is no record of it available to any person. 
If you do forget it, you must contact your project administrator 
and request a new one. 



/\nother useful control argument for the login command is 
-brief. If you use the terminal several times a day, you may not 
want to see the introductory information that follows receipt of 
your password (lines 5 through 7 in the first example). Here is 
an example of logging in using the -brief control argument: 



! login PSissle Doc 

Password : 
! newpassWMWWW 

r 11 :29 1 .798 599 


-brief 



The logout command also accepts a -brief control argument 



When used 
banner . 



! logout 
hangup 



•brief 



with the logout command, -brief suppresses the logout 



The -hold control argument to the logout command aids the 
person who uses your terminal after you. It retains the terminal 
connection after you have logged out, and prints the Multics 
banner in readiness for another person to log in: 



logout -hold 

PSissle Doc logged out 

CPU usage . . . 



Multics MR3.0: . 
Load = 23 out of 



60 
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You can include several control arguments with one command, 
as long as they are acceptable to the command and are typed after 
the command but on the same line. For example: 



login PSissle Doc -change_password -brief 

Password : 

pwsWMMWWMWWW 

New Password: 

newpassWWWWM 

New Password Again: 

newpassWWWWW 

Password changed. 

r 11 :37 2.381 1 121 



When you combine the two control arguments to the logout command, 
the results may surprise you. Here is the complete interaction, 
from ready message to new login -- Pam is trying this out by 
logging in again: 



r 1 1 : 


39 0.043 


32 






! logou 


t -brief 


-hold 






<blan 


k line from "^ult 


ics 


here> 


! login 


PSissle 


Doc 







The -brief control argument carries over into the new login 
session — no banner is printed! You must still use the "login 

, ^.x>o.a^i. m^ only indication you have that 

is that Multics sends a blank 



new login session, though. The 
Multics is ready for a new user 



line after it logs you out. 



As you learn about more commands, read through the command 
descriptions (Appendix B) to find out about the control arguments 
available to you with each command. 
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SECTIOH 3 



BASIC MULTICS COMMANDS 



COMMAND COIWENTIQNS 

Nearly all work that you want to accomplish on Multics is 
conveyed by commands. There are over 400 commands, many of which 
you may never use, some that you will use often. Most commands 
share several established rules of usage called conventions. 
(Some com.mands do not conform to some conventions — exceptions 
are documented in the individual command descriptions, Appendix 
B.) Several basic commands are introduced to illustrate the 
concepts and conventions presented in this section. 

Command Names 

Multics differentiates between uppercase and lowercase 

-^^""^•''^' ^ vj'ij.j.iij.Ooj.i vj. xiCtj-ii^ kj Cox ^ ca, J. \n cXj iD ojrjjCu. XiJ. J-KJ-H ^ L K^ do O J-COUCiO. 

For example, when you log in to the system you type "login". If 
Pam Sissle types "LOGIN" instead, Multics responds with an error 
message: 



=— ^ 



LOuIN PSissle Doc 

Incorrect login word "LOiilN". 

Please try again or type "help" for instructions. 



Com.mand names never contain blanks. Another way to say this 
is that a command name is always one character string : one group 
of alphabetic, numeric, and some special characters (periods", 
hyphens and underscores) unbroken by blanks. V/hen two or more 
words are incorporated in one character string, an underscore is 
used to simulate blanks between words, as with the "send_message" 
command or the "-change_password" control argument. 
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Many command names have shortened versions, called short 
names, that can be used interchangeably with the full names. The 
login command has the shortest short name, "1" (the logout 
command has no short name). Pam Sissle can log in this way: 



1 PSissle Doc 



Many of the most common control arguments have short names, too. 
Here is the full version and the shortened version of a Ic^in 
line from Section 2: ° 



login PSissle Doc -change_password -brief 
1 PSissle Doc -cpw -bf 



Short names are given in command descriptions (Appendix B) , next 
to the full names of those commands and control arguments that 
have shortened versions. In this manual, short names also appear 
1x1 parentheses after command names. 



Command Lines 

A command line consists of a command name, any desired or 
necessary arguments (separated from each other by blanks), and a 
newline. You must use blanks to separate the name of the command 
from its arguments, and to separate arguments from each other. 
Multics processes command lines in the order that they were 
typed. 



Every command li 
functions as a simultan 
beginning of the same 
line). These two acti 
completed a command li 
sent to Multics by typi 
have a different key fo 
the correct key) . Th 
newlines automatically; 
accompany it with a 
Multics), see "Login 
project administrator. 



ne ends with a newline. The newline 
ecus carriage return (returning you to the 
line) and linefeed (dropping you to a new 
ons are a signal to Multics that you have 
ne and want it acted on. The newline is 
ng the key marked "RETURN" (some terminals 
r this function — check at your site for 
e RETURN keys on most terminals act as 
if your RETURN key does not (if you must 
linefeed to send your command line to 
Problems" in Section 2 or talk to your 
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stopping a Command 



If you 
so by issu 
example . 
currently 1 

TrrMi Odd -.tViCi 

j KJ \jl. kjv^v^ ««J.J.>^ 

logged in, 
users. As 
interested 
key only ( 
your termin 
be a short 
message : 



want to stop a command while it is acting, you can do 
ing a QUIT signal . The who comand provides a good 
The who command prints a list of all the users 
ogged in, preceded by a Multics banner like the one 

n Trmi 1 o -C T "H . ^Ihp'-n AT-mi -hvi^f^" "-M-hn" T.n find c^'i'iT. wh n is 

you may not want to see the entire list of current 
soon as the system displays the names you are 
in, you may issue a QUIT signal by pressing the "QUIT" 
this key may be labeled BREAK, ATTi^, or INTERRUPT on 
al). When Multics receives the QUIT signal (there may 
delay) , it interrupts the command and displays a QUIT 



! who 






Multics MR8.0, 


load 32.0/40.0; 32 users, 28 interactive. 


2 daemons. 






Absentee users 


2/3 1 


10. SysDaemon 






Dumper .Daemon 






Roach. SysMaint 






DAdam.SoftWork 






PSissle.Doc 




<she presses QUIT here> 


QUIT 






r 13:14 0.099 


59 


level 2 



At this point, you are at commana level z; Muixics nas creaxea a 
new command level for you. To return to command level 1 , you 
should type release -all: 



r 


13: 


14 


0.099 


59, 


level 


2 


! r( 


slease 


-all 








r 


13: 


15 


0.062 


41 







When Multics prints a ready message with no level number, you are 
back at command level 1 , which is where you started. For more 
information on the QUIT signal, see Part II. 
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ARGUMENT CONVENTIONS 

Arguments are character strings included on the command line 
that provide any information necessary for a command to act as 
you want it to. The way arguments are typed in a command line is 
shown on a syntax line in the individual command descriptions 
(Appendix B) . A generalized example of a syntax line is: 



command argumenti argument2 argument^ 



for as many arguments as the command accepts. Each command has 
its own list of the arguments that it can accept; these lists of 
arguments are also included in command descriptions. 

One command may accept several different kinds of arguments; 
each kind is discussed below. When several arguments can be 
accepted on one command line, the order in which they are typed 
is often significant. (Such requirements are indicated in the 
syntax lines.) If you type arguments in the wrong order,, or if 
you type fewer arguments than necessary for the command to do 
what you want, Multics usually sends you an error messa^^e 
pointing out your mistake: 



i whom 

Segment whom not found. 
r 13:18 0.068 98 



If your mistaken command is still understandable to Multics, the 
command acts on whatever information you gave it. In this case, 
the results will probably not be what you intended. 

The Standard Argument 

One kind of argument is called simply an argument. It can 
be any item on which the command performs its action. Thus, such 
items as numerical values, the Person_id, and the Project id 
function as arguments when they are called for in a command liEe. 
You have already seen two examples of this kind of argument in 
the login command line: 



! login PSissle Doc 
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This syntax line in the "login" command description would be: 



login Person id Project id 



followed by a description of what words could be used as the 
arguments — in this case the user's Person_id and Project_id. 

These two arguments are required v/ith the login command; if 
you don't include them you will receive a message reminding you 
to do so. Other arguments, those placed in braces on the syntax 
line, are optional. Here is an example of a command syntax line 
that includes an optional argument: 



calendar (date} 



The braces {{]) indicate that the enclosed argument is optional. 
If you type only "calendar" on the command line, the system 
prints out, at your terminal, a calendar of the current month. 
If you type the command name and a date of the form MM/DD/YY: 



calendar 03/01 /72 



you receive a calendar for the month you specified. (Note: yoa 
must be using a terminal that has 120 or more characters per line 
for the calendar to be printed correctly.) 

Pathname Arguments 

The most common kind of argument is the pathname argument. 
All information that you create and store on Multics is grouped 
into segments . For example, this section of this manual is 
stored in a segment named "section_3". You give your segments 
names, called pathnames, that tell the system where your segments 
are located. (Segments are discussed in more detail in Sections 
4 and 5, and pathnames in Section 6.) 

Many commands are designed to act on segments; for these 
commands, you provide the pathname of the appropriate segment on 
the command line. When you type the name of this segment as one 
of the arguments to a command, the system finds the segment by 
its pathname and gives it to the command to act on. 
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The syntax line for a command with a pathname argument is: 



command path 



or, if the pathname is optional: 




An example of a command that requires a pathname argument is the 
print command (short name "pr"), which prints a header and the 
text of Pam Sissle'^ segment "tadpole" at her terminal: 



print tadpole 

tadpole 05/02/80 1322.5 mst Mon 

Selective listing: Class Amphibia, Superorder Salienta, 
Order Anura, Suborder Procoela. 
<rest of text> 



In the print command, the order of arguments on a command line is 
significant. The print command takes two optional arguments: 
line numbers that specify where to begin and end printing. You 
give these arguments if you do not want your whole segment 
printed (when using line number arguments, the header is not 
printed). If you want to use these arguments, you must type them 
after the pathname. Por example: 



print tadpole 23 25 
family Atelopodidae 

Atelopus pachydermus 

A. carrikeri 
r 13:23 0.06? 6? 



This restriction is conveyed by the order of the arguments in the 
syntax line: 



print path | begin__line I lend line} 
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Such restrictions are usually explained in the text of a command 
description. 



Control Arguments 

\J n + 1-1 oil 

II _L U ii. CX_1 L 

argument terms given 
with the information 
"10/17/80". Control 
a command. V/ith co 
control argument (pr 
particular modificat 
command to act diff 
nearly always optio 
several examples of c 



ar 



g, u-iu <:^ i i o o ucisui xDca ClUUVC, 



you replace the 



in a syntax line — "Person_id", "date" — 
you want the command to act on — "PSissle", 
arguments represent the special features of 
ntrol arguments, you ' always type the same 
eceded by a hyphen, of course) to get that 
ion. Because control arguments cause a 
erently than it normally would, they are 
nal. See "Variations" in Section 2 for 
ontrol arguments. 



Control arguments rarely need to be typed in a given order. 
However, control arguments do sometimes take arguments 
themselves, and there may be various kinds of restrictions to 
this kind of argument. One example of a command with a control 
argument that takes an argument was shown in Section 2, "Login 
Problems" : 



set tty -modes Ifecho , crecho 



where the -modes control argument takes the character string 
"Ifecho, crecho" as an argument. Restrictions on the order of 
control argum.ent3 in a command line are not revealed by the 
syntax line of the command description. For example, here is the 
syntax line of the set_tty command (short name "stty"): 



set_tty |-control argsj 



Such restrictions are explained 
relevant control argument. 



in the description of the 
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Default Arguments 



The last kind of argument 
argument that the system assumes 
nothing but a command name on 
arguments are assumptions about 
command. The print command (pr) 



default argument, 
in it, then typing 



is the default argument, an 
is present if you have typed 

the command line. Default 
what the user wants from a 

offers a clear example of a 



If your segment named "tadpole" has 39 lines 



is the same as typing: 



print tadpole 




(except that the header is suppressed when you specify line 






Very few commands have no arguments at all - 
have default arguments. 



- many commands 



CQMMUNICATirTg WITH OTHER USERS 

Multics offers several commands that allow you to 
communicate with other users. This facility — known as the mail 
facility — is very useful for such purposes as requesting 
permission to look at or use someone's segments, informing other 
users of upcoming events, or asking other users for assistance. 



T 
groups 
are i 
logged 
sendin 
user i 
commun 
protec 
mailbo 
accept 
au u oma 



he mail 
: mess 
ntended 
-in user 
g and r 
s logge 
ication, 
ted s e gm 
X is 



facility commands are descri 
age commands and mail commands, 
primarily for interactive exc 
s. Mail commands provide the ad 
eading mail at your convenience, 
d in or not. In order to rece 
you must have your own mai 
ent with the name Person_id.mbx 
named PSissle .mbx) . Your f 



bed 

M 
hang 
vant 
wh 
ive 
Ibox 



(for 
irst 

_messages command creates a permanent ma 

t 1 cally . 



below 
essage c 
es betwe 
age of w 
ether th 
either 
, a sp 

example 
use 
ilbox f 



in two 
ommands 
en two 
riting, 
e other 
type of 
ecially 
, Pam's 
of the 
or you 
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Message Commands 



RECEIVING MESSAGES 



In order to receive upcoming messages from, other users you 
must type the accept_messages command (short name "am") each time 
you log in. In addition, to receive the messages that have been 
sent to your mailbox since you last logged out, include the 
-print control argument on the command line. The accept_messages 
command allows subsequent messages from other users to be" printed 
at your terminal instantaneously. The User_id of the sender is 
included with each message, as well as the date and time: 



accept_messages -print 

Prom JCMulty.Doc 05/01/80 1107 mst Tue; 
Welcome to computers! 



After your messages are printed at your terminal they are deleted 
from your mailbox. 



Incoming 
what you may b 
they have no 
only half a c 
read the mess 
stopped — the 
command line, 
is typing the 
newline, her c 



messages are 

e working on. 

adverse effec 

ommand line 

age and then 

message is n 

For example, 

who command 

ommand line i 



printed on your terminal 

Although messages can i 

t on what you are doing. 

typed when a message ar 

continue typing from wh 

ot sent to the system as 

here Pam receives a mess 

Notice that until Pam 

s not sent to the system. 



regardless of 

nterrupt you. 

If you have 

rives, simply 

ere you were 

part of your 

age while she 

presses the 



! who <she has not typed a newline yet> 

Prom JTKissle.SoftWork 05/02/80 0828 mst Wed: Hello! 

! -brief <newline now> 
10. SysDaemon 
Backup . Daemon 

'Rnpnln P;irc!MoTn + 
.^- „j, ^^^^^ ^^ ^ 

Abelian. Croups 
JKLisa.SoftWork 
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If a message arrives ^v^rhile the system is printing out 
information, the message is printed and the system returns to 
printing as if nothing else had happened: 



DAdam.SoftWork 

From JTKissle.SoitWork 05/02/80 0829 mst Wed 
I just got registered today, too. 

PBar .iiardV/ork 
JCMulty.Doc 
PSissle.Doc 
JTKissle.SoftWork 
JMLie . Groups 
Galois . Groups 



There may be times when you don't want your work to be 
interrupted by messages. You can have your incoming messages 
collected and saved in your mailbox by typing the def er_messages 
^^,.....^..^ y^iu/. ,.ii^ix jrwut cxi c; 1 <z:au.y ou i c u e J. V e ifiebtjages 'di b your 
terminal, just type the accept_messages command, with the -print 
control argument, again. 



You automatically stop accepting messages at your terminal 
when you log out. Remember that you should type this command: 



accept_messages -print 



as soon as you log in each time. (You can have this done 
automatically after reading the "exec com." section in Part II.) 

SENDi:iG MESSAGES 

Interactive messages are sent with the send_message command 
(sm). There are two ways to send messages, as the syntax line 
implies: 



send_me3sage User_id {message! 
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For a short message, you can type the whole 
including your message, on one line: 



command line 




You may want to type a long message. When you type just the 
command, the user_id, and a newline, the system responds with the 
word "Input:". Now you are in input mode , the second form of the 
send_message command. As long as you remain in input mode, each 
line you type is sent immediately to the user you specified. To 
leave input mode and return to command level, type a period as 
the first and only character on a line, and then type a" newline. 
A ready message will follow. 



! send message JTKissle . Sof tWork 




Input : 




! Are you reading the New Users' Intro? 




! I'm just learning how to send messages - 


- can I 


! practice on you? 




r 14:10 . 084 117 





«\hen you are in input mode, Multics expecttj normal text from 
you, rather than commands. It recognizes only the erase and kill 
characters as special symbols. You may therefore use any of the 
other special characters listed in Section 1 , even though you 
should not use them when your message is included on the command 
line. In fact, you may even type command lines as messages, and 
they won't be acted on. Here is an example of both these 
features : 



! send messa^7,e JTKissle . Sof tWork 



Input : 



Say, Jakob, try typing this (it's really neat): 
sm JTKissle . Sof tWork I know your password! 

r 14:13 0.229 252 
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When you and another user both enter input mode, you can 
"chat" back and forth with each other: 



! send_message JTKissle . Sof tWork 

Input : 
! Are you reading the Hew Users' Intro? 

Prom JTKissle . ooftV/ork: 

Yes - I see you also got to Section 3- 
! What are you using Multics for? 

Prom JTKissle. SoftWork: 

I'm storing data from my research on infant behavior. 
! Very interesting. Well, back to Section 3. 



r 14:19 0.378 327 



Remember the period that takes you out of input mode! The period 
is easy to forget, and when you do, you send command lines to 
another user instead of to the computer. 



'^'ne sena_message command is an interactive command , the same 
way that Multics is an interactive system. You talk to Multics 
using commands, and Multics responds with requested information 
and ready messages. An interactive command talks to you by means 
of prompts, like "Input:" or "Password:", and you talk to it 
using requests , like the period that terminates input mode in the 
send_message command. After you type the command line and a 
newline for interactive commands, you are at request level : the 
system expects either appropriate information (like messages or a 
password) or a request from that command's list of accepted 
requests . 



Mail Commands 

The mail commands, print_mail (prm) and send_mail (sdm), are 
more complex interactive commands than the send_message command. 
Both commands have their own sets of requests for use within the 
command. Your first use of print_mail creates a permanent 
mailbox for you automatically, if you do not already have one. 

Once you have a mailbox, you can receive mail as well as 
messages. Incoming mail always goes directly to your mailbox. 
If you are logged in and are accepting messages, you 
automatically get a notice each time new mail arrives: 



Prom JGMulty.Doc 05/02/80 1213-7 mst Wed: You have mail. 






READING MAIL 



You can read your mail at any time by typing the print_mail 
command (prm). The system tells you how many messages you have 
vwithin the mail facility, mail is referred to as messages), and 
prints the messages, with banners, one at a time. After each 
message is printed, the sjrstiem sends you a prompting messa-^e and 
waits for you to type a request word in response. For example: 



! print mail 






You have 1 message. 






#1 (3 lines) 05/01/80 
Date: 2 May 1980 1210 
Prom: PBar .HardWork 
Subject: Meeting 


9:16 Mailed 
mst 


by: PBar .HardWork 


REMEMBER — there will 
people involved in the 
on Thursday at 10am in 


be a meeting of all 
company carpool plan, 
Davis Adam's office. 


print_mail: Delete #1 ? 


! <request 


here> 



Pive requests are accepted in answer to the prompt: 

yes 

deletes that message and prints the next one 

retains that message and prints the next one 

reprint 

repeats that message and the prompt 

quit 

retains that message and any messages not yet seen, and 
returns you to command level 

abort 

retains ALL current messages (even those you have 
deleted) and returns you to command level 
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Keep m mind that you may save mail in your mailbox as long as 
you want. V/hen you have answered the prompts for each message, 
you are returned to command level. A complete example follows: 



print_mail 

You have 3 messages 

#1 (7 lines) 05/02/80 10:02 Mailed by: JCMulty.Doc 
Date: 2 May 1980 10:02 mst 
From: JCMulty.Doc 
•Subject: Greetings 

Welcome onto the Multics system; once you learn a few 
of the basics, I think you'll find it very useful. 

I'm your project administrator. If you have any 
questions or problems, please feel free to talk to me. 

Have fun ! 

print_mail: Delete #1? ! yes 

#2 (2 lines) 05/02/80 10:42 Mailed by: JTKissle . Sof tWork 
Date: 2 May 1980 10:42 mst 
From: JTKissle . Sof tWork 
Subject: practice 

It's me again, practicing the send_mail command. 
That's all I can think of to say right now - bye. 

print_mail: Delete #2? ! quit 
r 10:54 0.394 489 



Pam deleted her first message, read her second one, and returned 
to com.m.and level, so now she has tv/o m^essa^^es in her mailbox. 

A useful control argument to the print mail command is 
"-list", which prints a summary of your messages before printing 
the text of each one. Here is the summary of Pam's remaining 
messages : 



print_mail -list 

Msg# Lines Date Time From Subject 

1 (2) 05/02/80 10:42 JTKissle . Sof tWork T^ractice 

2 (1) 05/02/80 10:49 JTKissle. Sof tWork Junk Mail 
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SENDING MAIL 

To write and send mail, use the send_mail command (sdm). 

Because this is a powerful command, you may use it at any one of 

several levels of complexity. Two ways of using send_mail are 

shown here. ~ 



The easiest way to send mail is 
User_id of the person you want to wr 
you for a title and for the text of 
are at send_mail request level, in 
mail in the same way as you terminat 
send_message command (sm): . type a p 
on a line, and then type a newline. 
telling you that your mail has "been s 
command level. This is how Jakob Ki 
mail to Pam Sissle: 



to type "send_mail" and the 
ite to. The command prompts 
the mail; at this point you 

input mode. Conclude your 
e input mode when using the 
eriod as the first character 
You now receive a message 
ent, and you are returned to 
ssle sent his first piece of 



! send mail PSissle.Doc 




Subject: ! practice 




Message: 




! It's me again, practicing 


the send mail command. 


! That's all I can think of 


to say right now - bye. 


Mail delivered to PSissle 


Doc 


r 14:47 0.487 675 





You may want to make 
it. You can edit the me 
"\f" (backslash-f ) instead 
Now you are in send_mail 
qedx edit mode, EXCEPT you 
that is done automatical 
mode requests, read Sectio 
leave edit mode, type "q". 
level, the send_mail comm 
you several choices by pr 
most useful requests are: 



changes to 
ssage after 

of a perio 
edit mode ! 

do not nee 
ly. (For i 
n 4, "Croat 
Rather th 
and stays at 
ompting you 



your mail befor 
you type it in, 
d when you end th 

It is very simi 
d to use the "w" 
nformation about 
ing and Editing T 
an returning you 

request level. 

for a request. 



e you send 

by typing 

e message. 

lar to the 

request — 

qedx edit 

ext".) To 

to command 

It allows 

The three 



print 



send 



prints the mail you just typed 



sends the mail to the mailbox of the user specified on 
the command line 



quit 



leaves send_mail request level and returns to command 
level. 
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Here is the way Jakob wrote his second piece of mail to P 



am 



! send 
Subj^ 


mail 
9ct : 


PSissle, 
! Junk 


Doc 

Mail 


Messj 


age: 






! I am doing more Dracticing. 

! \f 

! s/I am doing/This is/ 


! p 
This 


is more practicing. 


! '1 
send 
Mail" 


mail,: ! send 
delivered to PSissle. Doc 


send 
r 15" 


mail: 
:08 . . 


! quit 



A variety of other requests are available for both the 
send_mail command (sdm) and the read_mail command. (The 
read_mail command is more powerful than print mail for 
liio-xia. j^oL±oo uxii^ j^<^i j-xi^v^mxiig iiicLxx.; iv n tj Ti J' o u SiT ^ comiuruauxe witn 
the capabilities introduced here, try out some of the options 
listed in the descriptions of these commands in the MPM Commands. 



HELP COMMANDS 



The help Command 



The help command is an extremely useful interactive command 
that enables you to obtain information at your terminal about any 
given Multics command. The syntax line of the help command is: 



help I comiT]and_name I t -control args | 

Typing the help command with the name of anothe 
control arguments) causes Multics to begin p 
segm.ent about the command you requested: this i 
segment" consisting of blocks of information 
command. The first block informs you of how 
block is, how long the entire info segment is, 
short name of the command, the date on which the 
modified, and the syntax line and function of th 
each block, Multics prints the title of the ne 
you if you want more help: 



r command (and no 

rinting the info 

s an "information 

about a given 

long that first 
the full name and 

command was last 
e command. After 
xt block and asks 
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! help print 

>doc>inf o>pr . inf (6 lines follow; 25 in info) 
Q]/ 21/16 print, pr 

Syntax: pr path Ibegin line} |end_line} 

Function: prints an ASCII segment. 

Arguments required (13 lines). More help? ! <request> 



Some of the requests you may use are: 

yes 

print the next block 

skip 

skips the next "block 

rest 

prints the rest of the info segment, and returns jou to 
command level 

quit 

stops printing information, and returns you to command 
level 



Two of the control arguments to the help command, added to 

;ujiuua,iiu -ljluc: cLxuoi |y 

also particularly useful: 



b-'it! UUJlUUa,IiU -LXliC: CLXUOi ^^^ X -L >3 U OliC U. C O X JL C ^a. J. i.i.A. <J to C g,.iiiv- li u o , Ctj-v^ 



-brief 

prints a summary of the command information, including 
the syntax line and all arguments and control arguments 

-all 

prints the entire info segment without prompting you 

Try the help command with the name of one of the other 
commands you have worked with. You can use it to remind yourself 
of the correct syntax line of a command, or to learn about 
arguments and control arguments not discussed in this manual. 
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The list_help Command 

There are more than 500 info segments available to you at 
your terminal. The list_help command gives you a list of info 
segments that pertain to a given topic. The syntax line for this 
command is: 



list_help {topic] {-control argj 



It lists all the info segments whose names contain the given 
topic. For example, this command line: 



! list help help 



produces this list: 











help. 


changes 




help 








help 








info 


seg 


format 


•gi 











Typing the list_help command with just the -all control ar^^ument 



! list help -all 



gives you a (very long) list of all the info se^^ments 
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SECTION 4 
CREATING AND EDITING TEX' 



TEXT ED ITING COMMAND S 

After logging in and becoming familiar with the basic 
Multics environment, you will probably want to create and edit 
information on Multics. 



Multics has several text editors , powerful interactive 
commands that enable you to create, edit, and store your own 
segments. The two primary text editors on Multics are commands 
named qedx (short name "qx") and emacs. The qedx editor is a 
line-oriented editor; that is, you may make changes to one or 
more lines of text on a line by line basis. It is designed to be 
used on a printing terminal. There are two modes of operation in 
qedx: an input mode for entering new text, and an edit mode. 
The emacs editor is a character-oriented editor designed for 
video terminals. In emacs n*^ distin'^tion is made between edit 
and input modes - you are free to edit as you type in text. 

This section is a very brief introduction to both qedx and 
emacs. It describes the fundamentals of the commands and 
provides you with some of their most useful requests. However, 
the qedx and emacs editors have user guides that explain them 
fully: the emacs Text Editor Users' Guide, Order No. GH27, and 
the qedx Text Editor Users' Guide, Order No. CG40. One of these 
manuals should be among your group of essential Multics manuals. 



THE qedx EDITOR — PRINTING TERMINALS 

There are two modes of operation in qedx: an input mode for 
entering new text, and an edit mode . In input mode, you type 
information into the system; that is, you create text. In edit 
mode, you make changes to already existing text. A set of qedx 
requests allows you to enter and leave input mode, perform the 
various editing functions (substitution, deletion, printing) , and 
save your text in segments. 
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Creatin^R Text 



To enter the qedx editor, you type the qedx command, "qedx" 
(or "qx"), and a newline. Now you are in edit mode; notice that 
there is no prompt to remind you of this. In edit mode, qedx 
expects requests from you. 



To 



enter input mode and create text, type 



'a' 



— the append 



request — and then a newline. Now you type in your text. The 
erase and kill characters still perform their correcting 
functions within input mode. The characters "\f" together 
(backslash-f ) at the beginning of a line end your input session 
and return you to edit mode. Here is an examDle of creating 
text: 



r 13:17 1 .010 93 




! qedx 




! a 




! Doggerel 




! My dog is Brie: 




lie i-u-Lj-^^wo me 




! and chews on tennis 


balls . 


! He ' s got a stick. 




! but not one tick, 




! and sometimes barks 


in halls. 


! \f 





Be sure to type the "\f" as soon as you want to stop creating 
text. Until you type "\f", EVERYTHING you type is included as 
part of your text, including any requests you type thinking that 
you have already left input mode! So, if qedx does not respond 
to your editing requests, try typing "\f". When this occurs, you 
will probably need to delete several lines of editing requests 
from your text. 

Editing Text 

The qedx editor treats text as a series of numbered lines, 
the top line being line 1 . The editor also renumbers the text 
every time lines are added or deleted. For example, if you 
delete line 1 of your text, then line 2 becomes line 1, and line 
3 becomes line 2. Because the number of lines in your text 
changes often, the "$" character has been established to stand 
for the the last line, no matter what its number is. These line 
xx^m^oxo die ^mpjLxea -- hfiej do rjuT appear next to your text. 
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Within the editor is an implicit "current line pointer", 
which is always "pointing at" one line of your text — the last 
line you typed in or edited. The "=" (equal) request prints the 
line number of the current line, that is, where the current line 
pointer is located at the moment. 



Another method of locating lines of text moves the current 

line pointer to the line you request and then prints that line. 

This method consists only of an address : either an absolute line 

number ("2", "$"), a relative line number (relative to the 

current line: "-1", "+5")> a character string between slashes 
("/Br/"), or a period, which always prints the current line. For 
examDle: 



! 5 




He's got a stick, 




! +1 




but not one tick. 




! $ 




and sometimes barks 


in halls. 



There is no letter associated with this method of finding lines. 



Addresses are often used in conjunction with editing 
requests to specify on which lines changes are to be made. The 
request can be preceded by one address, as in this example using 

4-1 HJII /j^-l-^J \ ,,„„-!- J j^n I J_1 -I ^ . 




or it can be preceded by two addresses with a comma between (but 
no spaces), as in this example using the "p" (print) request: 



! 1 ,2p 

My dog is Brie 
he follows me 
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Using two addresses with a request means that the request 
operates on the first line TiiROUG-H the last line addressed. It 
is a good idea to use the 
you are doing what you intended. 



"p" request often, to make sure that 



To modify words within lines, use the "s" (substitute) 
request preceded by one or two addresses. The "s" request 
expects to be followed by two character strings separated by 
slashes (FORWARD slashes — not the backslash of the "\f" 
request!) telling it the old string and the new string: 



! s/from old/to new/ 



If you wanted to change the word "and" to the word "And" on the 
third line, you might type: 



1s/a/A/ 



Be careful, though - an "s" request makes this change on ALL 
instances of the character string you supply, on the line or 
lines you specify. If there is a mistake, you can use the "s" 
request to fix it: 



! 3 

And chews on tennis bAlls. 
! s/bA/ba/ 






The default value for the "d", "p", and "s" requests is the 
current line. 
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Saving Text 

When you are in the qedx editor (in either mode), the text 
you enter is kept in a temporary space called a buffer. All your 
work in this buffer is discarded when you leave qedx and return 
to command level (with the quit request^ "q")- In order to save 
your work in a segment, you must use the "w" (write) request, 
along with a name you choose, to write a copy of your work from 
the buffer into a segment with the name you have provided: 



<t 


ext of 


poem> 




! w 


Doggere 


1 




! 1 
r 


13:29 2 


.749 


1 102 



Now you have a permanent segment named "Doggerel". Remember: 
unless you type a "w" and the name of the segment, your work is 
not saved. 



When naming your segments, keep in mind that you should use 
only alphabetic and numeric characters, underscores (rather than 
spaces), periods, and hyphens. Names can be up to 32 characters 
long. Remember also that uppercase characters are distinguished 
from lowercase characters. 



When you want to return to qedx and edit an already existing 
segment, for example the "tadpole" segment, you must^ "read" a 
COPY of it into the editor at the beginning of your editing 
session. Do this at qedx request level by typing the "r" (read) 
request, followed by the name of your segment: 



! qx 

! r tadpole 



Before you do this, the buffer is empty 
of the segment "tadpole". 



Now it contains a copy 



Check the qedx Text Editor Users' Guide for any questions 
you may have. It describes all aspects of the qedx editor in 
complete detail. 
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THE emacs EDITOR — VIDEO TERMINALS 

The emacs editor is designed especially for use at a video 
terminal. It is a character-oriented editor: the cursor of the 
terminal (the blinking underscore or square) acts as aTvisible 
pointer to one character at a time. Text is entered simply by 
typing. Changes can be made at any time, by typing requests that 
move the cursor to the point desired and then adding or deleting 
as you wish. A limited set of requests is described below. 



Creating Text 



To enter the emacs ed 
nev/line. Your screen cle 
Emacs Fundamental mode; 
mode line, is displayed n 
space above displays the 
workspace for text entry 
Below the mode line is a 
from emacs, and your repl 
interfere with your text. 



O r> T" Q Q TO 



-F-f- 






Tr/^iT ' -XT r^ r^ v\ 4- /^ -r* /~^ 



iter, you type the emacs command and a 
ars, and you are at request level, in 

a banner announcing this, called the 
ow at the bottom of your screen. The 
contents of the buffer (the temporary 

and editing) and is called a window. 

space called the minibuffer; messages 

ies, are displayed here, so as not to 

Here is a diagram illustrating a video 
^ c^^ ^^ . 



[] <this is the cursor> 



<this is the window> 



Emacs (Fundamental) - main 

<above is the mode line> 

<this is the minibuffer> 



To enter text, you simply type, as you would on a 
typewriter. Your text appears on the screen a few seconds after 
you enter it; type a carriage return whenever you want to start 
a new line. The lines displayed in the window are EXACTLY what 
your text contains. 
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You may erase characters and kill lines as you normally do 
on Multics, and then type in the correct text. Notice that while 
you work with emacs, the erase and kill characters actually cause 
the deleted material to disappear from your screen. 



uma.(jfc3 Requests 

You have a whole array of emacs requests for moving the 
cursor to the point where a correction is needed. The two types 
of requests introduced here are control characters and escape 
characters . 



A control character, for instance a "control P" , is executed 
with the key labeled CTL or CONTROL. You use it like the shift 
key, so that for a "control P" you hold down the CTL key WHILE 
typing an uppercase or lowercase P. A control character is 
expressed by a carat (") followed by the appropriate character: 
'^P for "control P" . 

Escape characters use the key labeled ESC, ESCAPE, ALT, or 
ALTMODE on your terminal. Do not hold this key down while you 
type its associated character — type ESC and release it, and 
THEN type the next character. An escape character is expressed 
by the letters ESC followed by the appropriate character: ESC V 
for "escape Y" . 

Editing Text 

In order to change some text already entered, you need to 
know how to position the cursor. Here is a short list of 
requests that move the cursor through the lines of your text. 
These requests operate even if the affected lines are not 
currently on display in the window (the window displays only 
about 20 lines of your text at a time). 

''P (prev-line-command) 

moves the cursor to the previous line, trying to stay 
in the same column. 



(next-line-command) 
moves the 
the column. 






"V (next-screen) 

displays the next screenful of text in this buffer, 
leaving the cursor ot the top of the screen. 
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ESC V (prev-screen) 

displays the previous screenful of text (one back) in 
this buffer, leaving the cursor at the top of the 
screen . 

ESC < (go-to-beginning-of-buffer ) 

moves to the first line of text in the buffer, leaving 
the cursor in front of the first character. 

ESC > (go-to-end-of-buffer) 

moves to the last line of text in the buffer, leaving 
the cursor just after the last character. 

The following requests are useful for moving the cursor within 
one line: 

''F (forward-char) 

moves the cursor forward a character at a time. 



ESC F 



(backward-char ) 

moves the cursor backward a character at a time. 

(forward-word ) 

moves the cursor forward a word at a time. 



ESC B (backward-word) 

moves the cursor backward a word at a time. 

"A (go-to-beginning-of-line) 

moves the cursor in front of the beginning of a line. 

"E (go-to-end-of-line) 

moves the cursor to just after the last character of a 
line . 



Once you reach the right place, you can use either the erase 
and kill characters or one of the following deletion requests: 

"D (delete-char ) 

delete the character at the cursor. 

ESC D (delete-word) 

delete the word at and forward (to the right) of the 
cursor. 

^K (kill-lines) 

delete from the cursor to the end of that line; when at 
an empty line, delete that. 

When you type any of these requests, the deleted text 
disappears from your screen, and surrounding text closes up the 
space. The cursor remains, and you just type in any text you'd 
like to add. The surrounding text moves aside as you type. 
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Saving Text 

As noted above, when you are in the emacs editor, the text 
you enter is kept in a tempora.ry space called a buffer. All jour 
work in this buffer is discarded when you leave emacs and return 
to coinmand level. In order to save your work on emacs you must 
issue the "write-file" request, "X'^w, to copy your text into a 
segment with a name you have provided. After typing "X"W, a 
message in the minibuffer prompts you for the pathname of the 
segment into which you v/ant to "write", or copy, your buffer's 
contents. (Whenever emacs prompts you, the cursor moves into the 
minibuffer so you can type your reply there without interfering 
with your previous work.) Type the pathname and a carriage 
return. Now a permanent segment is created with the contents of 
your buffer, and the cursor returns to its previous position in 
your text. Note that the pathname appears in the minibuffer. At 
this point you can continue adding text if you want, and repeat 
this request later, or you can leave the editor. 

To leave emacs, you type the "quit-the-editor " request, 
"X"C. If you have typed new text into your buffer, or changed it 
in any way without writing it out, emacs asks you if you really 
want to quit. You have to respond "yes" if you do. If you did 
write your buffer out, yoa are imm-odiately returned to command 
level. 



When you want to return to emacs and edit an already 
existing segment, for example the "tadpole" segment, you must 
place a COPY of the segment into the editor's buffer at the 
beginning of your editing session. Do this at emacs request 
level by typing the "find-file" request, "X"P, which will prompt 
for tne name of the segment to be edited. After the segment is 
read in and displayed in the window, the cursor is left at the 
beginning of the buffer. Since your screen is small, it does not 
always display your whole buffer, but it is there, nevertheless. 

G-etting Jlelp From Emacs 

The emacs editor has an extensive online documentation 
system that can provide information about any request, tell you 
what any request does, tell you what requests you gave recently, 

OT» Vl(Cl"i-n -^T r\-\-\ (-1o+OT»rri-iviiCv T.Tl/->0't- -n ,:^ rn -i -< r-, r-^ +■ A ^ y^ ^ ^ A r^ 1^ -P^-.^ ^ ^-r^r^_^-i-PA^ -4-r^^T^ 

To find out what any given key or control character does, 
type ESC ? and then the key or control character you have 
questions about. 



4-9 Cii24-00 



All other help requests center around the emacs "help" 
request, "_ (control-underscore). (On some terminals, "? 
performs this function; if one doesn't work, try the other). The 
help request may be your most useful request, as you begin 
experimenting with emacs. Type "'^_?" to find out more about what 
help facilities are available. 

Use the "LINEFEED" or "LP" key to remove the displays 
produced by these requests. If your terminal has an automatic 
line feed, you may need to turn off this feature to prevent these 
displays from vanishing from your screen as soon as they appear. 

See the emacs Text Editor Users' Guide for any questions you 
may have. It describes, in tutorial style, all aspects of the 
emacs editor. 
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SECTION 5 



SEGMENTS 



A segment is a collection of information identified by a 
pathname. A single segment may contain any amount of 
information, from none to over one million printed characters. 

As a new user, you will be working with A SCII ( 1 ) segments. 
An ASCII segment contains information that can be printed on a 
terminal, for instance a list of names or a section of a manual. 
A non-ASCII segment cannot successfully be printed on a terminal: 
it would appear as strings of digits and backslashes. 

There are many commands on Multics that enable you to work 
with both your own segments and those of other users. In this 
section you are introduced to several commands that help you 

mp ri i "ni] "i n "h p 'vntir* q d rf rri o n + q 



VIEWING SEGMENTS 



The print Command 

One of the most common commands used with segments is the 
print command (short name "pr"), introduced in Section 3. Here 
is the syntax line again: 



print path jbesin linel lend linel 



Try printing one of your segments using one or both of the 
optional arguments. 



(1) The word "ASCII" is the acronym for American Standard Code 
for Information Interchange. This is the code used by 
Multics and other computer systems to represent printable 
text . 
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Another , way to see your segment is to use an editing 
command, as you did to create your segments. For example: 



! qedx 




! r Doggerel 




! 1,$p 




My dog is Brie: 




he follows me 




and chews on tennis 


balls . 


He's got a stick, 




"but not one tick. 




and sometimes "barks 


in halls. 


! q 




r 14:25 0.1 1 9 1 50 





The dprint Command 

Another way to receive a printed copy (a dprint ) of your 
segment is to use the dprint command (dp). This command orders a 
copy of your segment to be printed, not at your terminal, but on 
a high-speed printing device called a line printer. The syntax 
line for the dprint command is: 




Two useful control arguments to this command are: 

-copy N, -cp N 

prints 2, 3, or 4 copies, whichever you specify in 
place of N. If yoa do not use this control argument, 
you receive 1 copy (in other words, 1 is the default 
value for N) . 

-destination "address", -ds "address" 

allows you to specify where the dprint is to be sent. 
You type the address as an argument to the -ds control 
argument; if you want to include blanks, you must 
enclose the entire address in quotation marks, as 
indicated above. If you do not use this control 
argument, the default address is your Project__id. 

Your site may require that you include the -ds control 
argument with a particular value, in order to aid in 

I O o Vw* L/ 



r^.P-l 



1 +-Vi 



-r\ir' r> -\ 



if this is required at your site. 
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The order in which you type arguments is significant with this 
command: you should type the pathname AFTER you type all the 
control arguments. 



Here is a complete samiDle dDrint interaction: 



! dprint -ds "4th floor" tadpole 

1 request signalled, 2 in printer queue 3' 
r 14:26 0.442 236 



The message sent by Multics displays the number of dprints Pam 
requested, and informs her of the number of requests already in 
line (in "queue 3") waiting to be dprinted. 

Find out where you can have dprints delivered, and try 
dprinting a segment. 



NAMING SEGMEN TS 

As you saw when you created segments with an editor, you 
provide a name for each of your segments. You may add extra 
names, called alternate names , to the original name of your 
segment with the add_name command (an). The syntax line for the 
add name command is: 



add_name path name1 { . . . nameNj 



The path argument is your segment's original pathname, and name1 
is an alternate name; "I... nameN t " means that you can also add 
as many alternate names as you wish. For example: 



! add_name tadpole polliwog amphibian 
r 14:27 0.102 73 



In this example, two alternate names — "polliwog" and 
"amphibian" — are added to the segment "tadpole". 
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It is also possible to rename a segment, with the rename 
command (rn). Its syntax line is: 



rename path name 



and it allows only one new name ("frog") to replace the old name 
("tadpole") : 



1 rename tadpole frog 
r 14:29 0.061 67 



The rename command has no effect on any alternate names your 
segment might have: the alternate names remain with the segment. 

If you decide that one (or more) of the names of a segment 
in not appropriate, you may delete it with the delete_name 
command ( dn) : 



delete name paths 



Here is an example: 



! delete_name polliwo^ 
r 14:29 0.054 55 



"ow the segment "frog" has only one alternate name: "amphibian". 



Deleting the names of a segment is quite different from 
deleting the segment itself. You may delete as many names as you 
want, as long as you do not delete every name from the segment. 
A segment must have at least one name though, so if you 
accidentally attempt to delete every name, you receive a warning 
message: 



! delete_name amphibian frog 

delete_name: The operation would leave no names on 
entry. >udd>Doc>PSissle>f rog 



The first name listed on the above command line does get deleted, 
though. 



5-4 



CH24-00 



SEGMENT ATTRIBUTES 

The names of a segment are considered to be among its 
attributes , or characteristics. Other attributes of a segment 
are the author, the length, and the access modes : what permission 
you have to see, change, and add to your segment (access 



The list command (is) gives you information about several 
attributes of your segments. The list command syntax line is: 



list |path| 



When you include the name of a segment on the list command line, 
you receive information concerning three attributes of that 
segment. Here is a list of the attributes of the segment 
"Doggerel" : 



! list Doggerel 




Segments = 1 , Lengths = 


-- 1 


r w 1 Doggerel 




r 1 -4- : 99 "^ • 1 '^J 1 O 









The list command response begins with a header line that gives 
the total number of segments and the sum of their sizes. On the 
next line, the first group of letters ("r w") identifies what 
combination of the three access modes you are permitted on the 
segments. Here you have permission to £ead (see) your segment 
and write (edit) it. The second attribute ("1") is the size of 
your segment, in pages . A page of a segment is up to or exactly 
4096 characters. The third attribute is the list of names for 
the segment, in this case the one name "Doggerel". 
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V/hen you type the list command with no arguments, you get a 
list like the one described above, except that it includes 
information' about all of your segments. It also begins with a 
header: 



! list 

Segments = 4, Lengths 

r w 2 lizard 

r w 2 frog 

r w 1 Doggerel 

PSissle.mbx 

r 14:40 0.271 102 



= 5 



The last segment listed is Pam's mailbox. The absence of access 
attributes, and the "0" length, do not mean that you have no mail 
now. They signify that you cannot use your mailbox segment with 
any standard commands (like print); you have access only through 
the mail facility commands. 



DELETING SEGMENT S 

Finally, to get rid of a segment that you no longer need, 
use the delete command (dl) with the name of a command: 



delete frog 

r 14:42 0.305 214 



When you delete a segment that has alternate names, they are 
automatically deleted too. 

Try creating a few practice segments. Add, change, and 
delete names and segments, using the list command to check what 
you have done. 

For information on seeing other people's segments, read 
Section 6, "Directories". To discover how to share your segments 
with other users, read Section 7, "Access". 
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SECTION 6 



DIRECTORIES 



A directory is a catalogue of the segments ''beneath" it. It 
contains information about all the attributes of each segment. 
Every segment and directory in the system (except the root 
d irector y, the originating directory of the Multics system] Is 
immediately under another directory. Imagine it this way: 



directory 



/segmentA 




segment^ 



) 



segment2 



i> 



Without realizing it, you have been working "under" your own 
directory. This directory is called your home dire ctory . It is 
usually named after you; its name is the same as your Person_id. 
You are always placed in your home directory when you log in7 so 
when you log in, your home directory is your working directory . 
(You learn how to make another directory your working directory 
in "Changing Directories" below. ) The list command can be 
thought of as a command that prints the contents of your home 
directory: the list of segments under your Person__id, and the 
attributes of each segment. Here is a diagram of Pam Sissle's 
home directory: 
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Each user in your project has a home directory similar to 
yours. The home directories of users are often called user 
directories. All of the user directories of the people in your 
project are grouped under another directory: the project 
directory. Your project directory has the same name as your 
Project_id. For example: 



Doc 



PSissle 



rY7Vv-\ 

(seg\ ^seg^ /seg\ 



JCMulty 




Your project is one of many projects that use your Multics 
system. All of the project directories are gathered under a 
directory called the user__directory directory, or "udd". 
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The segments and directories just described are part of the 
Hultics storage system . Its organization is analogous to the 
structure of - an inverted tree: 




udd 



sss 



Doc 



SoftWork 



P C; T c; c; 1 (=. 



Doggerel 




PSissle .mbx 



The udd directory, and several additional directories governing 
other parts of the Multics system (not shown above), are directly 
beneath the root directory, which stands alone at the top of the 
directory hierarchy . 



6-3 



C424-00 



PATHNAf^ES 



Absolute Pathnames 

Every segment in the Multics storage system is identified by 
its absolute pathname . The absolute pathname of a segment is 
actually a series of names, separated by the ">" (greater-than ) 
character, representing the position of that segment in this 
directory hierarchy. For example, the pathname: 



>udd>Doc>PSissle>frog 



stands for the segment named "frog", located under the user 
directory named "PSissle". The "PSissle" directory is stored 
under the project directory "Doc", which in turn is stored under 
the directory "udd", which is stored under the root directory 
(">"). 



When you type the absolute pathname of a segment, it always 
ends with the segment name. The other names in the absolute 
pathname are all names of directories. 



Notice that the root directory is not explicitly named in 
the absolute pathname. Because it is present in the path of 
every segment, its presence is always implied by the initial ">" 
character of the pathname. 



Relative Pathnames 



The pathnames you have been using in earlier sections of 
this manual are called relati ve pathnames . Relative pathnames 
(which never begin with the ">" character) are shortened' versions 
of absolute pathnames. The relative pathname of a segment begins 
after -- is RELATIVE to — the name of your working directory. 
When you type a relative pathname, the system automatically adds 
on the absolute pathname of your working directory. Thus when 
Pam Sissle is in her home directory and types: 



print Doggerel 
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She sees the same segment that she would see if she typed: 




iPoT convenience, use relative pathnames whenever you can: 
all segments under your working directory. 



for 



There are many times when absolute pathnames are useful, and 
even essential. To print someone else's segment, you type the 
absolute pathname, since you do not have that segment in your own 
directory. Pam Sissle, from her home directory, prints Jakob 
Kissle's segment "neonate" with this command line: 



print >udd>SoftV/ork>JTKissle> neonate 



To place a copy of this segment in her own directory, so 
that she may modify it for her own use, Pam uses the copy command 
(cp) : 



copy >udd>Sof tWork>JTKissle>neonate neonate 
r 14:54 0.191 82 



The syntax line for the copy command is: 



copy original path new path 



The first pathname is the name of the segment that is to be 
copied. The segment "neonate" is in Jakob's directory, so Pam 
specifies its absolute pathname. She wants the copy of Jakob's 
segment to be placed in her home directory. Because she is 
already in her home directory, the system automatically places 
the rest of the absolute pathname in front of the relative 
pathname . 
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Access to Segments 

Many of the commands you have learned about in previous 
sections can he used with absolute pathnames, for example the 
dprint command and the segment naming commands (see Section 5). 
However, you may not have the correct access to the segments when 
you try to use these commands. If you do not, you will receive 
an error message like this one: 



copy >udd>G-roups>JMLie>ortho eight 

copy: Incorrect access on entry. >udd>Groups>JMLie>ortho 

r 14:56 0.076 69 



If this happens to you, try sending a message to the person whose 
segment you want, asking for the correct access. Also, read 
Section 7, "Access", for more information about access. 



CREATIIJO DIRECTORIES 

It is possible to remain in your home directory and do all 
your work on Multics from there. It is also possible for you to 
create a directory underneath your home directory. You can even 
create your own directory hierarchy, if you like. You can then 
place both new and existing segments into these directories. 
This can be very useful as a means of organizing your segments 
into categories. 



To create a directory, use the create_dir command (cd) with 
the name of the new directory: 



create_dir mammals 
r 14:59 0.068 69 



You may use the create_dir command (cd) to continue building a 
directory hierarchy under your home directory up to 1 5 
directories from the root. 



To place existing segments under the "mammals" directory, 
you may use either the copy command (cp) or the move command. 
The copy command is used primarily for making copies of other 
people's segments, as shown above. 
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The move command (mv) is most useful for moving your own 
segments from your home directory to a more appropriate 
directory. While the copy command leaves the original segment 
where it is and makes a copy in the new location the move 
command moves the original segment away from the first location 
and into the new location * The syntax line is: 




For example, Pam uses the move command from her home directory 



! move Doggerel mammals>Doggerel 
r 15:01 0.489 166 



In this example, Pam Sissle moves her "Doggerel" segment from her 
home directory down to her "mammals" directory, using relative 
pathnames (relative to her home directory) for both arguments. 

To place new segments under her "mammals" directory, Pam can 
use an editor to specify the location she wants at the same time 
she creates the segment. 



qedx 

a 

I do not have a cat. 

What do you think of that? 

\f 

w mammals > Cattery 

q 

r 15:05 0.254 256 
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Instead of writing her text with just a segment name, she gives 
it a longer relative pathname that places the segment named 
"Cattery" in the "mammals" directory, which is assumed by Multics 
to be underneath her home directory. Here is a diagram of Pam's 
current directory hierarchy: 



PSissle 



^lizardy 



^PSissle .mbxN 



^77g) 



mammals 



/Ooggerely /catteryN 



The segment naming commands introduced in Section 5 can be 
used to add, change, and delete directory names also. 

CHA NGIxlG DIRE CTORI ES 

You may want to cnange to another directory and use it as 
your working directory. Your home directory has been your 
working directory so far. To change your v^rorking directory, use 
the change_wdir command with the pathname of the directory you 
wish to work with: 



change_wdir mammals 
r 1 5:09 0.036 67 



When you are working in another directory, relative pathnames are 
relative to THAT directory. For example, when Pam is in her home 
directory and she wants to print the "Cattery" segment (which is 
located in her "mammals" directory), she types: 



print raammals>Cattery 
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When she moves to the "mammals" directory, she types: 



! change_wdir mammals 

r 15:11 0.039 52 
! print Cattery 



To check on what your current working directory is, use the 
print_wdir command (pwd): 



! print_wdir 

>udd>Doc>PSi3sle>mammals 
r 15:14 0.034 43 



The print_wdir command always prints the absolute pathname of 
your working directory. 

To return to your home directory, use the change_wdir 
command without any pathnames after it. In the example below, 
Pam has followed the change_wdir command with the print- wdir 
command, to reassure herself of her position: ~ 





—I 


! change 


wdir 


r 15:1 


5 0.027 40 


! print 


wdir 


>udd>L 


oc>PSissle 


15:15 


0.035 42 



The default argument of the change_wdir command is always the 
pathname of your home directory. 
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DELETIl^G DIRECTORIES 

Finally, you may delete directories as well as segments, 
with the delete_dir command (dd). Because the accidental 
deletion of a directory could cause so much pain, the system asks 
if you really want to take this step: 



delete_dir mammals 

delete_dir: Do you want to delete the directory 
>udd>Doc>PSissle>mammals?? ! yes 
r 14:57 0.434 102 



When you delete a directory, you delete ALL the directories and 
segments under it, so be cautious with this command. 
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SECTION 7 



ACCESS 



The access control facility provides "both flexibility and 
security for your work on Multics. You control who has access to 
each of your segments: which users have the right to see a given 
segment, to modify it, and, for a segment that contains a 
program, to execute it. Directories may also be controlled in 
this manner. 



S EGMENT ACCE SS 

There are four access modes that you set to determine the 

level of permission a user has for a particular segment. Listed 

below are descriptions of the four modes, and those commands 

treated in this manual that a user has available with each mode. 



reaa \,r^ 

allows a user to read, or 
segment 



view, the contents of the 



COMMANDS: 

copy 

dprint (dp) 

move 

print (pr) 

qedx "r" request 

write (w) 

allows a user to change the contents of the segment 

COMMANDS: 

qedx "w" request 



7-1 



CH24-00 



execute (e) 

if the segment is a program, allows a user to execute 
the program. Execute access is not necessary at the 
level of this manual. 

null (n) 

denies a user all access to the segment 



You may assign any combination of the r 



w 



want to assign the n mode, you must assign it alone. 



and e modes. If you 



Every segment has its own ACL ~ access control list. This 
list contains the full User_ids of those users who have access to 
the segment, and which access modes each user has been assigned. 
The full User_id is a three-component name that includes the tag 
component discussed briefly at the beginning of Section 2: 



JTKissle.SoftWork.^ 






j.j.^uj.j.'vvj. jwoi. oi.i'^ oi.OJ.i±gj OliC OJOUCill XliL/CiCHJUJ-VCXV 

or as an "absentee" user (see Part II). It is usually "^", which 
means "any tag is acceptable". V/henever anyone tries to use any 



segment, that per; 



in 



"ull User id must match one of the entries 



on the ACL of that particular segment; 
access to that segment. 



otherwise the user has no 



You see part of an ACL when you type the list command (is); 
the access modes that you have been assigned to your own segments 
by default constitute your ACL entry. Here Pam Sissle checks her 
access to her "Doggerel" segment : 



! list Doggerel 

Segments = 1 , Lengths = 1 

r w 1 Doggerel 
r 16:18 0.070 90 



She has read and write permission on her segment, which allows 
her to do all she needs. This combination is the automatic 
default for most of your segments. 
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To see the complete ACL for her "Doggerel" segment, Pam uses 
the list_acl command (la) with the name of the segment: 



! 1 


LSt 


acl Doggerel 




r 


W 


PSissle . 


Doc. 


-^ 


r 


w 


■^.SysDaemon, 


^ 


r 


16 


:20 0.084 


89 





Until you have added more ACL entries yourself, there are tv/o 
default entries for every segment you create. The first one is 
your own (the one you see when you use the list command), giving 
read and write access to you when you log in with the given 
Project_id. The second is for the system daemons , software 
facilities that perform such functions as dprinting and saving 
backup copies of segments. Other users have null access by 
default. 



To grant other users access, you use the set_acl command 
(sa). The syntax line for this command is: 



set acl path access modes User id 



Here Pam gives Jakob Kissle read access to "Doggerel", because he 
wants to make a dprint of it: 



! set acl Doggerel r JTKissle . 3of tV/ork 
r 1^:21 0.047 42 



(If you are registered on more than one project, you may want to 
grant access to your other User_ids!) 

If Pam v^ants to let Jakob add his own verses to Doggerel, 
she must give him additional access. To change his access, she 
simply resets the ACL with the set acl command: 



! set_acl Doggerel rw JTKissle . SoftWork 
r 16:21 0.037 45 



7-3 



CH24-00 



Now when Pam checks the ACL on "Doggerel" this is what she sees: 



! 1: 


Lst 


acl Doggerel 






r 


w 


PSissle 


.Doe 


.* 




r 


w 


JTKissl( 


9.Soft¥o 


rk.^ 


r 


w 


*.SysDaemon 


, * 




r 


16 


:23 0.064 


83 







But when Jakob tries to add an alternate name 
segment, all he gets is an error message: 



to the 



add_name Doggerel wag_tales 

add_name: Incorrect access to directory containing 

entry. >Doc>PSissle>Doggerel 
r 16:25 0.093 92 



rr^ u^™ 4-„^^j -1-^ ^-u^^^^ ^^ AmrnrjT •dttiti"l;'. ^ -p -j-i ^ ^ ^w, ^v,-i- mu^ ^ ^ ^ ^^ ^ 

iiC UclvD i XCU U VJ Ulid-ii^C CLli J-i X XiTXUU X XJ UX bllC OCgUiCliO. XliO CLV^V^COO 

modes for segments govern the CONTENTS of segments. Segment 
attributes are stored in the directory containing the segments, 
30 Pam must also give Jakob appropriate access to her directory, 
if she wants to allow him to add alternate names. 



DIR ECTORY ACCESS 

These are the four access modes for directories. Notice 
that all the affected commands govern attributes of segments 

(names and access modes). 

status (s) 

allows a user to see the ATTRIBUTES of the existing 
segments under the specified directory 

COMMANDS: 

list (Is) 
list acl (la) 
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modify (m) 

allows a user to modify attributes of the existing 
segments under the specified directory 



COMMANDS: 




add name 


(an) 


delete 


(dl) 


delete acl 


(da) 


delete name 


(dn) 


rename 


(rn) 


set acl 


(sa) 



append (a) 

allows a user to create, 
the specified directory 



copy, or move segments under 



:OMMAi^DS: 



copy 

create 

move 



dir 



(cp) 
(cd) 
(mv) 



null (n) 

denies a user all access to the directory. May not be 
assigned in combination with any of tne other directory 
access modes. 

As with the segment access modes, both you and the system daemons 
have complete access (sma) to all your segments and directories 
by default . 



Use the set_acl command (sa) again to set the ACL for 
directories. Aside from using s, m, and a combinations rather 
than r, e, and w, there is one quirk you may take advantage of 
when setting access for directories: when setting access on your 
working directory, you may use "-wd" in place of the directory's 
pathname. For example, here Pam gives Jakob access to her 
directory so that he may add alternate names to the segments in 
that directory: 



oc; o ca,U J. — w U. 



d X j:v 1 s s ± e . D 01 i; w o r K 



Of course, Jakob is now free to do other things in the directory 
too, such as changing the access on the segments underneath it, 
or even deleting them. It is often a good idea to think 
carefully before granting more than "r" and "s" access to other 
users. 
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To see who now has access to her directory 
list_aGl command (la) with the -wd argument: 



Pam uses the 



! list_acl -wd 

sma PSissle .Doc . * 

sma JTKissle.SoftWork. * 

sma * . SysDaemon . * 

r 16:51 0.040 77 



Finally, to delete the access of a particular user, use the 
delete_acl command (da). Its syntax line is: 



delete acl path User id 



For example, here Pam has decided not to let Jakob have access to 
her directory (the -wd argument can be used with all the access 
commands ) : 



delete_acl -wd JTKissle.SoftWork 
r 16:56 0.034 45 



him 



Jakob still maintains the segment access that Pam gave ..^-, 
though. If Pam decides to delete his access to the "Doggerel" 
segment, she uses the delete_acl command with the name of the 
segment : 



! delete acl Doggerel 
r 16:5F 0.038 41 



JTKissle.SoftWork 



The access control facility is much more extensive than this 
brief introduction has suggested. For a complete discussion of 
access, see the descriptions of these commands in the MPM 
Commands manual. 
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APPENDIX A 
GLOSSARY 



absolute pathname 

see pathname, absolute 

access control 

a system of permission assigned by users for their own 
segments and directories, determining who may see, 
change, and add to each one. See Section 7, "Access". 

access modes 

identify the types of access that may be set for a 
segment or directory. The access modes for segments 
are read (r), write (w) , execute (e), and null (n); 
those for directories are status (s), modify (m) , 
append (a), and null (n). See "Segment Access" in 
Section 7* 

ACL, access control list 

a list of the users who have access to a particular 
segment or directory, and a description (using access 
modes) of the degree of access allowed to each user. 
See "Segment Access" in Section 7. 

address 

within the qedx command, a character or character 
string that identifies one line of text. See "The qedx 
Editor" in Section 4- 

alternate name 

an additional name for a segment or directory, assigned 
by the add_name command. A segment or directory can be 
referred to equally well by its original name or any of 
its alternate names. See "Naming Segments" in Section 
5. 

argument 

information included with a command on a command line. 
See "Argument Conventions" in Section 5. 
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ASCII 

acronym for American Standard Code for Information 

Interchange, the standard code used to represent 

printable text on Multics. With it, all the characters 

normally found on a typewriter keyboard, plus many 

special characters, may be represented. See Section 5, 
"Segments" . 

attribute 

a characteristic of a segment. A segment has many 
attributes, such as its names, the author, its ACL, and 
its size; the attributes can be examined with the list 
command. See "Segment Attributes" in Section 5. 

banner 

one or more lines, in a standard format, that begin or 
comprise certain computer messages; also called a 
header. See "Logging In" in Section 2. 

buffer 

within a text editing command (qedx or emacs), a 
temporary workspace in which you create and edit text. 
To store that work in a segment you must "write it out" 
(make a permanent copy) using the qedx "w" (write) 
request or the emacs "X'V/ request. See Section 4, 
"Creating and Editing Text". 

character string 

one group of characters unbroken by blanks; signifies 
one word to Multics. The characters may include 
alphabetic, numeric, and some other characters 
(periods, hyphens, and underscores). See "Command 
Hames" in Section %. 

command 

an instruction to Multics; the command name. See 
Section 3, "Basic Multics Commands". 

command level 

the state the system is in when it is ready to accept a 
command from you. See also "request level". See 
"Logging In" in Section 2. 

command line 

one complete instruction to Multics, including a 

command name, arguments to that command, if any, and a 

newline. See "Command Lines" in Section 3* 

control argument 

an optional command argument that begins with a hyphen. 
Control arguments are typed exactly as indicated in 
command descriptions. See "Login/Logout Variations" in 
Section 2. 
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crash 

an unplanned termination of computer operation, due to 
hardware or software difficulties. 

cursor 

the blinking square or underscore that marks your 
current position on a video terminal. See "Login 
Problems" in Section 2. 

daemon 

one of several system facilities that perform such 
services as dprinting segments on a line printer 
( lO.SysDaemon is the User_id for this facility) and 
saving copies of , segments as a means of backup 
(Dumper .SysDaemonj . See "Segment Access" in Section 7. 

default 

the value or action that the system assumes when none 

has been specified by the user. See "Default 

Arguments" in Section 3« 

directory 

a "catalogue" containing the names and other attributes 
of all segments and directories immediately beneath it 
in the storage system (the directory hierarchy). See 
Section 6, "Directories". 

directory, home 

the directory that you work from when you first log in. 
The pathname for this directory is usually of the form 

/ U.U.U./ J: J. u J feo o J. u./ r fci b uii xu. oec oeCu-Lun O, 

"Directories" . 

directory, root 

see root directory. 

directory, working 

the directory that you are currently working from. 
Your home directory is always the working directory 
when you log in; to move to another directory, use the 
change_wdir command (cwd) with the desired pathname. 
See Section 6, "Directories". 

directory hierarchy 

the orga.ni !7,at i onal structure of the Multics stora^-^e 
system. It resembles an inverted tree, with the root 
directory at the top, and subordinate directories 
emanating downward as branches. The lowest levels of 
each branch, the "leaves", are segments. See Section 
6, "Directories". 
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dprint (for daemon print) 

the command to print segments on a line printer rather 
than a terminal. The printed segments themselves are 
referred to as dprints. See "The dprint Command" in 
Section 5* 

edit mode 

a mode of operation within a few interactive commands 
(q_edx, send_mail) in which the command is ready to 
accept editing requests from you. See also "request 
level". 

erase character 

the "#" character; it erases the character, or 
continuous series of blanks or tabs, immediately 
preceding it. For example, both 



and 



"tha#e" 



"tha e###e" 



are seen by Multics as "the". See "Multics 
Conventions" in Section 1 . 

error message 

a message sent by Multics informing you that a command 
you typed was not carried out, and indicating what was 
wrong. For example, "Segment ! not found." is returned 
if you mistakenly type the exclamation point before a 
command. See "Login Problems" in Section 2. 

hardware 

the physical devices and electronic circuitry that 
comprise a computer. See "The Multics System" in 
Section 1 . 

hardwired 

connected directly and permanently to the computer; 

USUa.lly refers to t^'l'nm'nPil.c!. Roc^ "nnnnoo+nmrr minci 

Terminal" in Section 2. 

header 

see banner 

help file 

see info segment. 

home directory 

see directory, home 



A-4 CH24-00 



info segment 

a segment containing information about a given command. 
Typing the help command, followed with the name of a 
command, prints the info segment for that command at 
your terminal. See "The help Command" in Section 3* 

j.iipu.0 iuuu-c; 

a mode of operation within many interactive commands 
(for example, qedx or send_message) in which the 
command is ready to accept text from you. Input mode 
is usually terminated by you with a special character 
(described in individual command descriptions. Appendix 
B). See "Sending Messages" in Section 3. 

interactive 

a mode of operation in which you and the computer 
exchange information directly and immediately, through 
a terminal. Multics is primarily an interactive 
system. See "The Multics System" in Section 1 . 

interactive command 

a command that communicates interactively with you: the 
command expects requests or other appropriate 
information from you (such as a password or the text of 
a message), and responds to you with messages or other 






send_message, help and 
Messages" in Section 5' 



ipj_c;o KJ J. xiiucidouxvc: oU niiu ctiiu.io cLxo qou.A, 



print mail. 



Ld; 
See 



"Sending 



kill character 



-I- Top 



"@' 



v^ij.aiacuerj lu u.e-Leues a-i-j. previouSj.y~"Tiyp^ 



characters on the current line. i"^or example, 
"Itdellet esall@ It" 



becomes 



It 



See "Multics Conventions" in Section 1 . 



logging in 

Entering the Multics system, 
with the login command, 
interactive command. See 
Leaving Multics". 



This can be accomplished 
The login command is an 
Section 2. "Entering a.nd 



logging out 

Leaving the Multics system (with the logout command) . 
See Section 2, "Entering and jjeaving Multics". 
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mailbox 

a specially protected segment used to store messages 
and mail from other users. Typically, each person has 
a mailbox named Person_id.mbx under the home directory. 
A permanent mailbox is created for you the first time 
you type the accept_messages command (am) or the 
print_mail command (prm). See "Communicating With 
Other Users" in Section 3. 

memory 

the computer hardware in which all segments are stored. 
See "User Identification" in Section 2. 

modem 

the machinery that transmits electronic signals between 
a terminal, a telephone, and the computer. See 
"Connecting The Terminal" in Section 2. 



newline 

the newline, caused by typing the key labeled "RETURN" 
(or another key designated for this purpose, such as 
"CR" or "LP"), consists of two actions: a carriage 
return and a linefeed. It is the signal to Multics 
that a command line is ready to be processed. See 
"Command Lines" in Section 3. 

operating system 

tne system software that supervises the processing of 
commands, controls system hardware, and organizes the 
tasks to be accomplished. See "The Multics System" in 
Section 2. 

page 

the smallest unit of storage that is allocated to 
segments. One page contains up to 4096 characters. 
See "Segment Attributes" in Section 5. 

A character string known only to you. The system knows 
only an encoded form of your password. A password is 
assigned to you when you are registered on the system. 
The password is used when you log in, along with the 
Person_id, to verify your identity. See "User 
Identification" in Section 2. 

pathname 

a name of a segment or directory that specifies its 
location in the storage system. A pathname is either 
absolute or relative. See "Pathname Arguments" in 
Section 3 and "Pathnames" in Section 6. 
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pathname, absolute 

a segment or directory name preceded by the series of 
directory names that lead from the root to that 
segment; each level in the pathna^me is preceded by a 
">". For example, the absolute pathname for a segment 
under a user's home directory is designated this way: 

>udd>Pro ject_id>Person_id>segment_name 

All absolute pathnames begin with ">". See "Absolute 
Pathnames" in Section 6. 

pathname, relative 

the pathname that uniquely locates a segment or 
directory relative to your working directory, by 
listing only that part of the absolute pathname that 
comes after the name of the working directory. For 
example, the relative pathname for a segment that 
resides in a directory one level under the working 
directory is designated this way: 

lower_dir>segment_name 

All relative pathnames begin WITHOUT ">". See 
"Relative Pathnames" in Section 6. 

Person_id 

A unique user identification; the first component of 
the [Jser_id. See "User Identification" in Section 2. 

project administrator 

Within this manual, this term is used for those people 
who have special access privileges that enable them to 
register new users, control the allocation of their 
system resources, and perform other administrative 
functions. At your site these functions may be shared 
among several people, perhaps having several different 
titles (system administrator and registrar, for 
instance). See "Login Problems" in Section 2. 

Project_id 

The second component of the User_id; used for 
accounting purposes. See "User Identification" in 
Section 2. 

process 

one session with Multics, usually from login to logout. 
For the user, this means one terminal session. 
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QUIT signal 

a signal to Multics that you want to interrupt its 
current action. To send this signal you press the key 
labeled "ATTN", "BREAK", or "INTERRUPT"; the system 
responds with a QUIT banner and a ready message from a 
new command level. Type "release -all" to return to 
the first command level. The QUIT signal has nothing 
to do with the "quit" requests of interactive commands. 
See "Stopping A Command" in Section 3. 

ready message 

the signal that Multics is at command level, ready for 
the next command. Ready messages may differ from site 
to site, but often- include information such as the 
current time and date, and some measure of total system 
resource usage. See "Logging In" in Section 2. 

relative pathname 

see pathname, relative 

request 

within an interactive command, an instruction to the 
command, given at request level; the requests of an 
interactive command are analogous to the commands of 
the Multics system. See "Sending Messages" in Section 
3. 

request level 

the state in which an interactive command (for example 
qedx or send_mail) is ready to receive either 
appropriate information (text, a message) or a request 
from the command's list of accepted requests. Within 
the qedx command, request level is called "edit mode". 
See "Sending Messages" in Section 3. 

root directory 

the directory at the top of the Multics storage system; 
all other directories are subordinate to it. In 
absolute pathnames it is referred to by the initial 
">". See Section 6, "Directories". 

segment 

a unit of information (for example, text or a computer 
program), which is created and named by a user, and 
stored in the storage system. Each segment has a set 
of attributes, such as its primary and alternate names 
and its ACL. See Section 5, "Segments". 

short name 

the shortened version of a command or control argument 
name, used interchangeably with the full name. The 
short names are listed in individual command 
descriptions (Appendix B) . See "Command Names" in 
Section 3* 
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software 

the programs that control the activities of the 
computer. See "The Multics System" in Section 1. 

storage system 

the combination of hardware and software that Multics 
uses for storing information. The information is 
grouped into segments and catalogued in directories. 
See also "directory hierarchy". See Section 6, 
"Directories" . 

syntax line 

in command descriptions, the line that demonstrates the 
structure of a ■ complete command line for that 
particular command. See "Argument Conventions" in 
Section 3« 

SysDaemon 

see daemon 

tag 

see User_id 

terminal 

a typewriter-like piece of hardware that allows a user 
to interact directly with the computer system. See 
"The Multics System" in Section 1 and "Login Problems" 
in Section 2. 

text editor 

a very powerful interactive command that allows you to 
enter text into the system and to edit it. See Section 
4, "Creating and Editing Text". 

timesharing 

the ability of the computer system to allow many users, 
with tasks of all sizes, to use the system 
simultaneously. See "The Multics System" in Section 1 . 

User_id 

A unique three-component name assigned to each Multics 
user. The User_id discussed in this manual consists 
most often of tne first two components, separated by a 
period: 

Person_id. Pro ject_id 

The third component, the "tag", is discussed in 
Section 7- See also "User Identification" in Section 
2. 

working directory 

see directory, working. 
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APPENDIX B 



COMMAND DESCRIPTIONS 



This appendix contains abbreviated descriptions of the 
commands and arguments discussed in this manual. For complete 
descriptions of these and other commands, see the MPM Commands 
manual. The "help" command is another useful source of 
information, especially while you are at your terminal. 

accept_messages , am 

Allows incoming messages to be printed at the user's 
terminal. 

SYNTAX: am { -control_argi 

AHCUMENT : 

_^J. J.J.J.U, — jj ± 

this control argument prints all deferred 
messages: those that were received since the user 
last typed the def er_messages command or logged 
out. If -print is not given, the default is to 
print only those messages that are sent after this 
accept_mes3ages command is typed. 
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add_name, an 

Adds alternate names to the existing names of a 
segment . 

SYi^'TAX: an path namel { ... nameNj 

ARGUMENTS: 

path 

is the pathname of the segment or directory to 
which the alternate names are added. 

names 

are the alternate names to be added to the segment 
or directory. 



calendar 

Prints a one-month calendar. 

SYNTAX: calendar j date J 

ARGUMENT: 

date 

is a date, of the form MM/DD/YY, that identifies 
which month is to be printed. If date is not 
given, the default is to print a calendar for the 
current month. 



change_wdir, cwd 

Changes the user's working directory to the directorv 
specified. "^ 

oii^±B.Ai cwd < path I 

ARGUMENT : 

path 

is the pathname of the directory that is to become 
the working directory. If path is not given, the 
home directory is assumed. 
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copy, cp 

Creates a copy of the specified segment in the 
specified directory with the specified name. 

SYNTAX: cp original_path new_path 

ARG-IJMElrTS : 

original_path 

is the pathname of the segment to be copied. 

new_path 

is the pathname of the copy. The user may choose 
the segment name of the copy when typing this 
pathname. 



create_dir, cd 

Creates a directory at a specified location in the 
directory hierarchy. 

SYNTAX: cd path 

ARCUMExNT : 

path 

is the pathname of the directory to be created. 



def er_me3sages , dm 

Prevents messages from being printed at the user's 
terminal. (See also the accept_messages command.) 

SYNTAX: dm 
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delete, dl 

Deletes the specified segment. 

SYNTAX: dl path 

ARGUMENT : 

path 

is the pathname of the segment to be deleted. 



delete_acl, da 

Deletes entries from the ACL (access control list) of a 
segment or a directory. 

SYNTAX: da path User_id 

ARGUMENTS: 
path 

which access is to be removed. This argument may 
be "-wd" if you want to delete access from the 
working directory. 

User_id 

is the User_id of the person who is to be removed 
from the ACL. 



delete_dir, dd 

Deletes the specified directory and its subtree, 

SYNTAX: dd path 

Hraj-uMnjxri' : 

path 

is the pathname of the directory to be deleted 
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delete_name, dn 

Deletes specified names from a segment or directory. 

SYITTAX: dn paths 

AROUMENT : 

paths 

are the pathnames to be deleted. 



dprint, dp 

Prints the specified segment on a high-speed line 
printer . 

SYNTAX: dp t-control_args j path 

ARGUMENTS: 

-copy N, -cp N 

this control argument prints 2, 3, or 4 copies of 
the specified segment, according to the number 
supplied by the user. If -copy is not given, the 
default is 1 copy. 

-destination "address", -ds "address" 

This control argument specifies where the dprint 
is to be sent. To include blanks in the address, 
enclose the entire address in quotation marks; for 
a single character string this is unnecessary. If 
-ds is not given, the default is the user's 
Pro ject_id. 

All control arguments must be typed before the 
path argument. 

path 

is the pathname of the segment to be dprinted. 
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emacs 

Creates and edits text segments. 

Refer to Section 4 for command description. 



help 

Prints blocks of information (info segments) about how 
to use the specified command. 

SYi^TAX: help | command_name ( {-control argsj 

ARGUMENTS: 

command_name 

is the name of a Multics command. If no command 
name is given, the default is the help command 
info segment. 

-all, -a 

this control argument prints the entire info 
segment without prompting the user after each 
block. If -all is not given, the default is to 
prompt the user for a request after each block of 
information. 

-brief, -bf 

this control argument prints only a one-block 
summary of the command information. If -brief is 
not given, the default is to begin printing the 
standard set of information blocks, each one 
followed by a prompt. 

REQUESTS: 

quit 

stops printing information, and returns the user 
to command level. 

rest 

prints the rest of the info segment, and returns 
the user to command level. 

skip 

skips one information block. 

yes 

prints the next information block. 
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list, Is 

Prints information about specified segments and 
directories. 

tiYilTAA : Is 1 Datn f l-r-.nnr. ml a-rxTf 

ARGUMENTS: 

path 

is the pathname of the segment or directory to be 
listed. The pathname of a segment is used without 
the -dir control argument to print the size, all 
names, and access information about that segment. 
The pathname of a directory is used with the -dir 
control argument to print access and name 

-directory, -dir, -dr 

this control argument, when used without the path 
argument, prints access and name information about 
all directories located immediately beneath the 
working directory. 

V/hen no arguments are given with the list command, 
the default is to print information about all 
segments immediately beneath the working 
directory. 



list acl, la 



Lists the ACL (access control list) of a segment or 
directory. 

SYNTAX: la path 

ARGUMENT : 

path 

is the pathname of the segment or directory for 
which the ACL is to be listed. This argument may 
be "-wd" if you want to list the ACL of the 
working directory. 
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list_help, Ih 

Prints a list of the info segments that pertain to the 
specified topic. 

SYNTAX: Ih topic { -control_arg| 

ARGUME:\iTS: 

topic 

is the topic to be searched for. 

-all, -a 

this control argument prints the names of all the 
info segments. , If -all is not given, the default 
is to print the names of only those info segments 
that pertain to the topic given. 



login, 1 

Identifies the user and grants access to the system. 



SYNTAX: 
ARGUMENTS: 



1 Person_id Project_id {-control args| 



Person_id 

is the Per3on_id of the user logging in. 

Pro ject_id 

is the Project__id of the user logging in. This 
argument is optional under some circumstances; 
check with your project administrator. 

-brief 

this control argument suppresses the standard set 
of messages associated with a successful login. 
If -brief is not given, the default is to print 
these messages as soon as the user types the 
correct password. 

-change_password, -cpw 

this control argument changes the user's password 
to a newly given password of the user's choice 
(not longer than eight characters). The user is 
prompted for both the old and the new password 
after this control argument is given; the user 
should NOT type the new password on the command 
line . 
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logout 

Terminates a user session and breaks the terminal's 
connection to the computer. 



QVT-.Tm A V 



ARGUMENTS: 

-brief, =bf 

this control argument suppresses the standard 
logout messages. If -brief is not given, the 
default is to print the logout message. 

-hold, -hd 

this control argument terminates the user's 
session but retains the terminal connection, 
allowing another user to log in without redialing 
the modem; the initial Multics banner (greeting 
message) is printed. If -hold is not given, the 
default is to end both the user session and the 
terminal connection, and print the message 
"hangup". If both -hold and -brief are given, 
neither the logout message nor the initial Multics 
banner are printed, and only a newline signals the 
user to log in. 



move 



Moves a segment to the specified directory with a 
specified name. 

SYNTAX: move original_path new_path 

ARGUMENTS : 

original_path 

is the pathname of the segment to be moved. 

new_path 

is the pathname of the moved segment. The user 
may choose the name of the moved segment when 
typing this pathname. 
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print, pr 

Prints a specified segment on the user's terminal. 

SYNTAX: pr path ibegin_line! iend_line} 

ARGUMENTS: 

path 

is the pathname of the segment to be printed. 

begin_line 

is the line number on which printing begins. If no 
number is given, the default is to begin printing 
from line 1 . 

end_line 

is the line number on which printing ends. If no 
line number is given, the default is to stop 
printing after the last line of the segment. The 
end_line argument can only be used when the 
begin line argument is also used. 



print_mail, prm 

Prints all messages residing in the user's mailbox, and 
prompts for req_uests about deletion after each message. 

SYNTAX: prm j -control_arg| 

ARGUMENT : 

-list, -Is 

this control argument prints a summary of the 
messages in the mailbox, before printing the 
messages. If -list is not given, the default is to 
begin printing the messages immediately. 

REQUESTS: 

abort 

retains all current messages and returns the user 
to command level. 

no 

retains the preceding message and prints the next 
one . 
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quit 

retains the preceding message and any subsequent 
(unprinted) messages, and returns the user to 
command level. 

reprint 

repeats the preceding message and the prompting 
message . 



yes 



deletes the preceding message and prints the next 
one . 



print_wdir, pwd 

Prints the pathname of the user's current working 
directory . 



SYNTAX: 



pwd 



qedx, qx 

Creates and edits text segments. 

Refer to Section 4 for command description. 



release, rl 

Returns the user to the previously held command level; 
typed after the user sends a QUIT signal. 



SYNTAX: 
ARGUMENT 



rl {-control arg} 



-all, -a 

oil IS controj. argument returns the user to command 
level 1. If -all is not given, the default is to 
return the user to the most recently held command 
level . 



!-1 1 
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rename, rn 

Renames the specified segment or directory with the 
specified name. 

SYNTAX: rn path name 

ARGUMENTS: 

path 

is the pathname of the segment or directory to be 
renamed . 

name 

is the new name of the segment or directory. 
Remember that no two segments or directories that 
reside immediately under the same directory can 
have the same name. 



se]nd_mail, sdm 

Sends mPiil f.n P\r)ni-.hnv y-xor^ar^r, T»orfTo4-o-K.^,^ ^^ -i-V-~ ~ i---,-^- 

-^ - - -- — -----^* jj^xk^v^ix J. v^gjxo ubx ou. Kjii out; tjlyauemj 

the 3end_mail command prompts for the User id of the 
recipient. ~ 

SYNTAX: sdm User_id 

REQUESTS: 

print 

prints the existing message. 

quit 

leaves the send_mail request level and returns the 
user to command level. 

send 

sends the existing message to the mailbox of the 
user specified on the command line, along with an 
interactive message that prints "You have mail." 
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send_inessage, sm 

Sends one or more interactive messages to another user. 

SYNTAX: sm user_id {message } 

Aitu-uriJiii^ xo : 

User_id 

is the User_id of the recipient, in the form 
"Project_id.Person_id". Note the period between 
the recipient's Person_id and Project_id. 

message 

is the one-line message to be sent. If message is 
not given on the command line, the default is to 
print the prompting message "Input:" and a 
newline. The user may then type as many one-line 
messages as desired; each line is sent 
immediately. 

Type a period ( . ) to terminate message input and 
return to command level. 



set_acl, sa 

Modifies the ACL (access control list) of a segment or 
directory. 

SYNTAX: sa path access_modes User id 

ARGUMENTS: 

path 

is the pathname of the segment or directory for 
which access is to be set. This argument may be 
"-wd" if you want to set the ACL on the working 
directory. 
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access_modes 

are the access modes you wish to set for the given 
user on the given segment. Access modes are: 

SEGMENTS : DIRECTORIES : 

read (r) status (s) 

write (w) modify (m) 

execute (e) append (a) 

null (n) null (n) 

User_id 

is the LJser_id of the person whose ACL entry you 
wish to add or change. 



who 



Prints a header similar to the initial banner seen at 
login, and lists the User_ids of the people currently 
logged in to the system. 

SYiNTAX: who 1 -control_arg! 

ARGUMENT : 

-brief, -bf 

this control argument suppresses printing of the 
header . 
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INDEX 



MISCELLANEOUS 

_ (underscore) character 3-1 
! character 1-2 
# (erase) character 1-3, A-4 
@ (kill) character 1-3, A-5 

A 

absolute pathname 6-4, A-7 

accept_messages command 3-9, 
B-1 

access control 1-1, 7-1, A-1 

access modes A-1 
directories 7-4 
see also ACL 
segments 5-5, 7-1 

ACL (access control list) 7-2 
A-1 

address (qedx) 4-3, A-1 
add_name command 5-3, B-2 
alternate names 5-3, A-1 



am 



see accept messages command 



an 

see add_name command 

argument 2-7, 3-4, A-1 

control argument 2-7, 3-7, 

A-2 
default 3-8 
optional 3-5 
pathname 3-5 

ASCII segments 5-1 , A-2 

attributes 5-5, A-2 



banner 2-2, A-2 

buffer A-2 

emacs 4-6 

qedx 4-5 



calendar command 3-5 , B-2 

carriage return 
see newline 
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cd 

see create_dir command 

change_wdir command 6-S, B-2 

character string 3-1 , A-2 

command 3-1 

argument 2-7, 3-4, A-1 
see also argument 

command level 2-4, 3-3, A-2 

command line 2-3, 3-2, A-2 

definition 2-3, A-2 

descriptions B-1 

interactive 2-3, 3-12, A-5 

names 3-1 

alternate names 5-3, A-1 
short names 3-2, A-8 

QUIT signal 3-3, A-8 

syntax line 3-4, A-9 

commands 

accept_m.essages 3-9, B-1 
add_name 5-3, B-2 
calendar 3-5, B-2 
change_¥dir 6-8, B-2 
copy 6-5, 6-6, B-3 
create_dir 6-6, B-3 
def er_messages 3-10, B-3 
delete 5-6, B-4 
delete_acl 7-6, B-4 
delete_dir 6-10, B-4 
delete_name 5-4, B-5 
dprint 5-2, B-5 
emacs 4-6, B-6 
help 3-16, B-6 
list 5-5, 7-2, B-7 
list_acl 7-3, 7-6, B-7 
list_help 3-18, B-8 
login 2-3, 2-7, B-8 
logout 2-6, B-9 
move 6-7, B-9 
print 3-6, 3-8, 5-1 , B-10 
print_mail 3-13, B-10 
print_wdir 6-9, B-1 1 
qedx 4-1 , B-1 1 
release 3-3, B-1 1 
rename 5-4, B-1 2 
send_mail 3-15, B-1 2 
send_message 3-10, B-1 3 
set_acl 7-3, 7-5, B-1 3 
set tty 2-4, 3-7 



commands (cent) 

who 3-3, 3-9, B-1 4 

computer 1-1 

control argument 2-7, 3-7, 
A-2 

copy command 6-5, 6-6, B-3 

cp 

see copy command 

crash A-2 

create_dir command 6-6, B-3 

creating text 4-1 , 6-7 



cwd 



see change wdir command 



D 



da 

see delete_acl command 

daemon 7-3, A-3 

dd 

see delete_dir command 

default 3-8, A-3 

default argument 3-8 

defer_messages command 3-10, 
B-3 

delete command 5-6, B-4 

delete_acl command 7-6, B-4 

delete_dir command 6-10, B-4 

delete_name command 5-4, B-5 

deletion 

of characters 1-3 
of directories 6-10 
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deletion (cont) 
of lines 1-3 
of segment' names 5-4 
of segments 5-6 

directory 6-1 j A-3 
access modes 7-4 
home 6-1 , A-3 
root 6-1 , 6-4, A-8 
sharing 

see access control 
working 6-4, 6-8, A-3 

directory hierarchy 6-3, 6-6; 
A-3 



G 



dl 



see delete command 



dm 



see defer messages command 



dn 



see delete_name command 

dp 

see dprint command 

dprint A-4 

dprint command 5-2, B-5 

E 

edit mode A-4 

qedx command 4-1 
send_mail command 3-1 5 

editor 

see text editors 

emacs command 4-6, B-6 

erase (#) character 1-3, A-4 

error message 2-5, A-4 

exclamation point 1-2 



glossa.ry A-1 



n 



hardware 1 -1 , A-4 
hardwired 2-2, A-4 
help command 3-16, B-6 
home directory 6-1 , A-3 

I 



identification 2-1 
password 2-1 , A-6 

changing 2-7 
Person_id 2-1 , A-7 
Project_id 2-1 , A-7 
User_id 2-1 , A-9 

info segment 3-16, 3-18, A-5 
see also help command 

input mode A-5 
qedx command 4-1 
send_mail command 3-1 5 
send_message command 3-1 1 

interactive 1-1, A-5 

interactive command 3-12, A-5 
emacs 4-1 
help 3-16 
login 2-3 
print_mail 3-12 
qedx 4-1 
see aj-SO inuiviauaj. commanu 

names 
3end_mail 3-12 
send message 3-10 
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K 



kill (@) character 1-3, A~5 



L 



see login command 



la 

see list_acl command 

linefeed 

see newline 

list command 5-5, 7-2, B-7 

list a.nl nnmm^nd 7— "^ . 7 — fi , 

B-7 

list_help command 3-18, B-8 

login 2-1 , 2-2, A-5 
problems 2-4 

login command 2-3, 2-7, B-8 

logout 2-1 , 2-6, A-5 

logout command 2-6, B-9 

Is 

see list command 



m 



mail 3-12 

reading 3-13 
saving 3-1 3 
sending 3-15 

mailbox 3-8, 5-6, A-6 

memory 2-1 , A-6 

messages 

error 2-5, A-4 



messages (cont) 
interactive 3-9 
deferring 3-10 
receiving 3-9 
sending 3-10 
ready 2-4, A-8 

modem 2-2, A-6 

move command 6-7, B-9 



mv 



see move command 



N 



newline 3-2, A-6 



operating system 1-1, A-6 



page 5-5, A-6 

password 2-1 , A-6 
changing 2-7 

pathname 3-5 , A-6 
absolute 6-4, A-7 
argument 3-5 
relative 6-4, 6-8, A-7 

Person_id 2-1 , A-7 

pr 

see print command 

print command 3-6, 3-8, 5-1, 
B-10 

print_mail command 3-13, B-10 

print wdir command 6-9, B-1 1 
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prm 

see print_mail command 

process A-7 

project administrator 2-4, 
A-7 

project directory 6-2 

Project_id 2-1 , A-7 

pwd 

see print_¥dir command 

Q 

qedx command 4-1 , B-1 1 

QJIT signal 3-3, A-8 

qx 

see qedx command 

R 

ready message 2-4, A-8 

read_mail command 3-16 

relative pathname 6-4, 6-8, 
A-7 

release command 3-3, B-1 1 

rename command 5-4, B-1 2 

request 3-12, A-8 

RETURN key 
see newline 

rn 

see rename command 

root directory 6-1 , 6-4, k-\ 



sa 

see set_acl command 

sdm 

see send_mail command 

segments 3-5, 5-1, A-8 
access modes 7-1 
attributes 5-5, A-2 
creating 4-1 , 6-7 
info segment 

see info segment 
sharing 6-6 

see also access control 
size (page) 5-5, A-6 

send_mail command 3-15, B-1 2 

send_message command 3-10, 
B-1 3 

set_acl command 7-3, 7-5, 
B-1 3 

set_tty command 2-4, 3-7 

sharing segments 6-6 
see also access control 

short names 3-2, A-8 

sm 

see send_message command 

software 1 -1 , A-8 

storage system 6-2, A-9 



stty 



OQQ OQ+ -I-+--I-7- ^r^»vlvy^QV^^ 

UV^V^ KJV^O UtJ^ V^ V^lil ill 0,11 U. 



syntax line 3-4, A-9 



tag 7-2, A-9 
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terminal 1-2, A-9 
connection 2-2 
hardwired 2-2, A-4 

text editors 4-1 , A-9 
emacs 4-6 
qedx 4-1 

timesharing 1-1, A-9 



U 

udd 6-2 

underscore (_) character 3-1 

user directory 6-2 

user__directory_directory 6-2 

User_id 2-1 , A-9 
tag 7-2, A-9 

V/ 

who command 5-3, 3-9, B-14 

working directory 6-4, 6-8, 
A-3 
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